DOCUMENT:Q189632  11-AUG-1998  [vbwin]
TITLE   :BUG: Error in CoolBar Event Can Cause Hanging or Exception
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER:WINDOWS:5.0,6.0
OPER/SYS:WINDOWS
KEYWORDS:

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

 - Microsoft Visual Basic Professional and Enterprise Editions for
   Windows, versions 5.0, 6.0
---------------------------------------------------------------------

SYMPTOMS
========

When using a CoolBar control, your compiled application hangs or generates
an exception error or invalid page fault (IPF.)

CAUSE
=====

An unhandled error occurred in one of the CoolBar's Events.

RESOLUTION
==========

Handle the error with an On Error routine.

STATUS
======

Microsoft has confirmed this to be a bug in the Microsoft products listed
at the beginning of this article. We are researching this bug and will post
new information here in the Microsoft Knowledge Base as it becomes
available.

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

This problem only occurs in the compiled application and does not occur
from the IDE. When an unhandled error occurs in one of the CoolBar's
events, it hangs the application in Windows 95, but under Windows NT 4 or
Windows 98, it may produce an exception or IPF error.

Steps to Reproduce Behavior
---------------------------

1. Open a New Standard EXE project. Form1 is created by default.

2. Choose Components from the Project menu, check "Microsoft Windows Common
   Controls-3" and click OK.

3. Place a CoolBar control onto the form. CoolBar1 is created by default.

4. Place this code in the form's module:

      Private Sub CoolBar1_Click()
         Err.Raise 5
      End Sub

5. Choose Make exe from the File menu, and create an executable file.

6. Run the exe and click on the CoolBar control. (NOTE: You must click on
   one of the bars that separates the Bands rather than the Bands
   themselves.)

   You should get a dialog for Run-time error '5': "Invalid procedure call
   or argument" and the application should end. Instead, the application
   will either hang or generate an exception error or IPF.

7. Replace the code in the CoolBar's Click Event with this code which
   contains an error handler:

      Private Sub CoolBar1_Click()
         On Error Goto CBErr
         Err.Raise 5
         Exit Sub
      CBErr:
         MsgBox "Error " & Err.Number & ": " & Err.Description
         Resume Next
      End Sub

8. Repeat steps 5 and 6. This time you will get an error message, after
   which the application continues running normally.

Additional query words: kbDSupport kbDSD freeze lock GPF
kbVBp kbVBp500bug kbCtrl kbVBp600bug kbWinOS98 kbWinOS95 kbWinNT
======================================================================
Version           : WINDOWS:5.0,6.0
Platform          : WINDOWS
Issue type        : kbbug

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

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 1998.