Name
hw_SetClipboardAdapter -- install a clipboard adapter (V11.0)
Synopsis
int error = hw_SetClipboardAdapter(hwPluginBase *self, ULONG flags,
                                   struct hwTagList *tags);
Library
clipboard

Function
This function can be used to activate a plugin that has the HWPLUG_CAPS_CLIPBOARDADAPTER capability flag set. This function must only be called from inside your RequirePlugin() implementation. If this function succeeds, Hollywood's inbuilt clipboard handler will be completely replaced by the clipboard handler provided by your plugin and Hollywood will call into your plugin whenever it needs to access the clipboard. In the first parameter, you have to pass a pointer to the hwPluginBase that Hollywood has passed to your plugin's InitPlugin() function. The second parameter must be set to a combination of flags. The following flags are currently defined:

HWSCAFLAGS_PERMANENT:
If this flag is set, the clipboard adapter will be made permanent. This means that other plugins won't be able to overwrite this clipboard adapter with their own one. If HWSCAFLAGS_PERMANENT is set, all subsequent calls to hw_SetClipboardAdapter() will fail and your clipboard adapter will persist.

See Clipboard adapter plugins for information on how to write clipboard adapter plugins.

Designer compatibility
Unsupported

Inputs
self
hwPluginBase pointer passed to InitPlugin()
flags
combination of flags (see above)
tags
reserved for future use; set it to NULL for now
Results
error
error code or 0 for success
Show TOC