GetClipboardSequenceNumber

[This is preliminary documentation and subject to change.]

The GetClipboardSequenceNumber function returns the clipboard sequence number for the current window station.

DWORD GetClipboardSequenceNumber(VOID)
 

Parameters

This function has no parameters.

Return Value

The return value is the clipboard sequence number. If you do not have WINSTA_ACCESSCLIPBOARD access to the window station, the function returns zero.

Remarks

The system keeps a 32-bit serial number for the clipboard for each window station. This number is incremented whenever the contents of the clipboard change or the clipboard is emptied. You can track this value to determine whether the clipboard contents have changed and optimize creating DataObjects. If clipboard rendering is delayed, the sequence number is not incremented until the changes are rendered.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98 or later.
  Windows CE: Unsupported.
  Header: Declared in winuser.h.
  Import Library: Use user32.lib.

See Also

Clipboard Overview, Clipboard Functions