IAgentCommandsEx::GetHelpContextID

HRESULT GetHelpContextID(
   long * pulHelpID  // address of Commands object help topic ID
);

Retrieves the HelpContextID for a Commands object.

• Returns S_OK to indicate the operation was successful.

pulHelpID

Address of a variable that receives the context number of the help topic for the Commands object.

If you've created a Windows Help file for your application and set the character's HelpFile property, Microsoft Agent automatically calls Help when HelpModeOn is set to True and the user selects your Commands object. If there is a context number in the HelpContextID, Agent calls Help and searches for the topic identified by the current context number. The current context number is the value of HelpContextID for the Commands object.

This property applies only to your client application's use of the character; the setting does not affect other clients of the character or other characters of your client application.

Note  Building a Help file requires the Microsoft Windows Help Compiler.

See Also

IAgentCommandsEx::SetHelpContextID, IAgentCharacterEx::SetHelpModeOn, IAgentCharacterEx::SetHelpFileName