OleIsCurrentClipboard

Determines whether the data object pointer previously placed on the clipboard by the OleSetClipboard function is still on the clipboard.

WINOLEAPI OleIsCurrentClipboard(
  IDataObject * pDataObject  //Pointer to the data object previously 
                             // copied or cut
);
 

Parameter

pDataObject

[in] Pointer to the IDataObject interface on the data object containing clipboard data of interest, which the caller previously placed on the clipboard.

Return Values

S_OK

The IDataObject pointer is currently on the clipboard and the caller is the owner of the clipboard.

S_FALSE

The indicated pointer is not on the clipboard.

Remarks

OleIsCurrentClipboard only works for the data object used in the OleSetClipboard function. It cannot be called by the consumer of the data object to determine if the object that was on the clipboard at the previous OleGetClipboard call is still on the clipboard.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ole2.h.
  Import Library: Included as a resource in ole32.dll.

See Also

OleFlushClipboard, OleSetClipboard