KnowledgeBase Archive

An Archive of Early Microsoft KnowledgeBase Articles

View on GitHub

Q85430: DOC: Private Data Formats Freed by the Clipboard

Article: Q85430
Product(s): Microsoft Windows Software Development Kit
Version(s): WINDOWS:3.1
Operating System(s): 
Keyword(s): kbdocfix kb16bitonly kbClipboard kbSDKPlatform
Last Modified: 11-JUN-1999

3.00 3.10
WINDOWS
kbprg kbdocerr

-------------------------------------------------------------------------------
The information in this article applies to:

- Microsoft Windows Software Development Kit (SDK) 3.1 
-------------------------------------------------------------------------------

SUMMARY
=======

The documentation for the SetClipboardData function on pages 826-828 of the
"Microsoft Windows Software Development Kit: Programmer's Reference, Volume 2:
Functions" manual states that data placed on the clipboard in a private data
format is not automatically freed when removed from the clipboard. The
identifiers for private data formats are in the range CF_PRIVATEFIRST through
CF_PRIVATELAST. The statement in the manual is incorrect. Data that is placed on
the clipboard in a private format is automatically freed when the data is
removed from the clipboard.

MORE INFORMATION
================

Clipboard data in a private data format is automatically freed when the data is
removed from the clipboard. Windows sends the WM_DESTROYCLIPBOARD message to the
application that put the data on the clipboard before the data is freed. An
application can free any corresponding internal data when it receives the
WM_DESTROYCLIPBOARD message.

Private data in the CF_OWNERDISPLAY format is not automatically freed when the
data is removed from the clipboard. An application must free data of this format
when the application receives a WM_DESTROYCLIPBOARD message.

Additional query words: 3.00 3.10 docerr

======================================================================
Keywords          : kbdocfix kb16bitonly kbClipboard kbSDKPlatform 
Technology        : kbAudDeveloper kbWin3xSearch kbSDKSearch kbWinSDKSearch kbWinSDK310
Version           : WINDOWS:3.1

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.