BUG: WinHelp() Call Fails Using HELP_TCARD Option in Win32s

The information in this article applies to:

• Microsoft Win32 Application Programming Interface, included with Microsoft Win32s, 1.30c

SYMPTOMS

The WinHelp() call fails when using the HELP_TCARD option under Win32s. For example, the following WinHelp call fails and WinHelp does not appear:

   WinHelp(hWnd, "GENERIC.HLP", HELP_TCARD | HELP_CONTEXT, 99)

STATUS

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

MORE INFORMATION

The user is guided through the steps of a task when an application displays a sequence of instructions using training card help. A training card typically consists of text that explains a particular step and authorable buttons associated with TCard macros that allow the user to tell the application what to do next.

The training card instance of Windows Help is initiated by an application calling the WinHelp function and specifying the HELP_TCARD command in combination with another command such as HELP_CONTEXT. Subsequently, when the user clicks an authorable button in the training card, clicks a hot spot assigned to the TCard macro, or closes the training card, Windows Help notifies the application by sending it a WM_TCARD message.