DOCUMENT:Q171731  23-JUL-1997  [vbwin]
TITLE   :DOC: LoadResData Function Does Not Support All Formats
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER:4.0 5.0
OPER/SYS:WINDOWS
KEYWORDS:vb4all vb4win vb5all kbdocerr

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

 - Microsoft Visual Basic Control Creation, Learning, Professional, and
   Enterprise Editions for Windows, version 5.0
 - Microsoft Visual Basic Standard, Professional, and Enterprise Editions,
   16-bit and 32-bit, for Windows, version 4.0
---------------------------------------------------------------------

SUMMARY
=======

In the Microsoft Visual Basic Language Reference and in the online Help,
the LoadResData function reference incorrectly describes which resource
formats can be returned.

The syntax of the LoadResData function is:

    LoadResData(Index, Format).

The Index and Format parameters are required values that are used to
identify the resource ID and the resource formats respectively. The
documentation lists the following resource formats:

    Value      Description

    1          Cursor resource
    2          Bitmap resource
    3          Icon resource
    4          Menu resource
    5          Dialog box
    6          String resource
    7          Font directory resource
    8          Font resource
    9          Accelerator table
    10         User-defined resource
    12         Group cursor
    14         Group icon

However, formats 4, 5, 7, 8, 9, and 10 are not supported in Microsoft
Visual Basic.

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

The resource formats of Menu (4), Dialog box (5), and Accelerator table (9)
are examples of resources that require capabilities like callback functions
and Windows Message handling to be used successfully. These capabilities
are not currently supported in Visual Basic. Retrieving font (7 and 8) and
user-defined (10) resources are also not implemented in Visual Basic at
this time.

For additional information, please see the following article in the
Microsoft Knowledge Base:

   ARTICLE-ID: Q141505
   TITLE     : Using LoadResData with Binary Data

======================================================================
Keywords            : vb4all vb4win vb5all kbdocerr
Version             : 4.0 5.0
Platform            : 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.

Copyright Microsoft Corporation 1997.