DOCERR: DdeCreateDataHandle Documentation Errors

Last reviewed: January 26, 1996
Article ID: Q109131
The information in this article applies to:
  • Microsoft Windows Software Development Kit (SDK) for Windows version 3.1
  • Microsoft Win32 SDK, version 3.1

The documentation for the cbInitData and offSrcBuf parameters to the DdeCreateDataHandle function are incorrect. Here is the description given for these two parameters in the current documentation:

   cbInitData     Specifies the amount, in bytes, of memory to allocate for
                  the global memory object. If this parameter is zero, the
                  lpvSrcBuf parameter is ignored.

   offSrcBuf      Specifies an offset, in bytes, from the beginning of the
                  buffer pointed to by the lpvSrcBuf parameter. The data
                  beginning at this offset is copied from the buffer to the
                  global memory object.

These parameters should be documented as follows:

   cbInitData     Specifies the amount, in bytes, of memory to copy from
                  the source buffer specified by lpvSrcBuf.

   offTargetBuf   Specifies an offset, in bytes, from the beginning of the
                  global memory object* allocated by DdeCreateDataHandle.
                  Data from the source buffer is copied to the global
                  memory object, beginning at this offset.

                  *The size of the global memory object allocated by
                  DdeCreateDataHandle is equal to the sum of cbInitData and
                  offTargetBuf.


Additional reference words: 3.10
KBCategory: kbui kbdocerr
KBSubcategory: UsrDde


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.

Last reviewed: January 26, 1996
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.