Call VBSetErrorMessage() In Response to VBM_ Messages Only

ID: Q80403


The information in this article applies to:
  • Microsoft Visual Basic Control Development Kit (CDK) for Microsoft Visual Basic Programming system for Windows
  • Microsoft Visual Basic Professional Toolkit for Windows, version 1.0
  • Microsoft Visual Basic Professional Edition for Windows, version 2.0


SYMPTOMS

The Visual Basic Control Development Kit (CDK) API function VBSetErrorMessage() operates correctly only when called in response to a VBM_ message, such as VBM_SETPROPERTY.


STATUS

This behavior is by design.


MORE INFORMATION

The VBSetErrorMessage() function can be called from a custom control in response to a VBM_ message to pass an error number and message back to Visual Basic. When execution returns to Visual Basic, a trappable run-time error will occur, with the error number and message specified in the call to VBSetErrorMessage.

The VBSetErrorMessage routine works only in response to messages that originate from Visual Basic itself (VBM_ messages). Visual Basic responds to the return code for VBM_ messages, and in turn sets the error condition in the program. If the return code for a VBM_ message is True, Visual Basic will generate an error condition. For other messages (non VBM_ messages), Visual Basic must pass along the return code to the originator of the message (usually Windows); therefore, Visual Basic will not generate an error condition for these messages.


REFERENCES

"Microsoft Visual Basic: Control Development Guide," (c) 1992, page 117 (shipped with Professional Toolkit)

"Microsoft Visual Basic: Control Development Guide," (c) 1991, page 108 (part no. 20666)

Additional query words: docerr 1.00 2.00

Keywords :
Version : :1.0; WINDOWS:2.0
Platform : WINDOWS
Issue type :


Last Reviewed: January 25, 2000
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.