DOC: Incorrect Prototype & Memory Allocation for PX_Blob

Last reviewed: July 10, 1997
Article ID: Q135630
1.50 1.51 1.52 | 2.00 2.10 2.20
WINDOWS        | WINDOWS NT
kbole kbdocerr kbdocfix

The information in this article applies to:

  • The Microsoft Foundation Classes (MFC) included with: Microsoft OLE Control Developer's Kit (CDK) versions 1.0, 1.1, 1.2

SUMMARY

The documentation for the prototype of PX_Blob in the CDK Books Online is shown incorrectly as:

   BOOL PX_Blob( CPropExchange* pPX, LPCTSTR pszPropName,
      HGLOBAL*& hBlob, HGLOBAL hBlobDefault = NULL );

The actual prototype as shown in the CDK source code in Afxctl.h is:

   BOOL PX_Blob(CPropExchange* pPX, LPCTSTR pszPropName, HGLOBAL& hBlob,
      HGLOBAL hBlobDefault = NULL);

MORE INFORMATION

Note that the third parameter is incorrectly listed as HGLOBAL*& hBlob in the documentation and should instead be HGLOBAL& hBlob as shown in the actual prototype.

There is also another error in the PX_Blob remarks section of the documentation. It states the following incorrect information:

   Note that PX_Blob will allocate memory, using the new operator, when
   loading BLOB-type properties. Therefore, the destructor of your
   control should call delete on any BLOB-type property pointers
   to free up any memory allocated to your control.

This correct documentation should be as follows:

   Note that PX_Blob will allocate memory, using the Windows GlobalAlloc
   API, when loading BLOB-type properties. You are responsible for
   freeing this memory. Therefore, the destructor of your control should
   call GlobalFree on any BLOB-type property handles to free up any
   memory allocated to your control.

The problems described in this article were fixed in Visual C++, 32-bit edition, version 4.0 and later.


KBCategory: kbole kbdocerr kbdocfix
KBSubcategory: CDKIss
Additional reference words: 1.50 1.51 1.52 2.00 2.10 2.20 4.00
Keywords : CDKIss kbdocerr kbdocfix kbole
Technology : kbMfc
Version : 1.50 1.51 1.52 | 2.00 2.10 2.20
Platform : NT WINDOWS


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: July 10, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.