HH_GET_LAST_ERROR command
Returns information about the last error that occurred in the HTML Help ActiveX control (Hhctrl.ocx).
pszFile |
dwData |
Must be NULL.
|
A pointer to a HH_LAST_ERROR structure.
|
Example
USES_CONVERSIONS; // For Unicode to ANSI string conversion
HH_LAST_ERROR lasterror ;
HWND hwnd = HtmlHelp(
hOwner,
NULL,
HH_GET_LAST_ERROR,
reinterpret_cast<DWORD>(&lasterror)) ;
// Make sure that HH_GET_LAST_ERROR succeeded.
if (hwnd != 0)
{
// Only report an error if we found one:
if (FAILED(lasterror.hr))
{
// Is there a text message to display...
if (lasterror.description)
{
// Convert the String to ANSI
TCHAR* pDesc = OLE2T(lasterror.description) ;
::SysFreeString(lasterror.description) ;
// Display
MessageBox(hOwner, pDesc,
"Help Error", MB_OK) ;
}
}
}
Return value
- On failure, zero.
- On success, non zero.
Comments
- There is no user interface (UI) associated with this command. The caller is responsible for returning error codes and text to a UI, such as a message box or a text file, and/or responding to an error.
- This command reports on a limited range of possible errors. If a call to HtmlHelp() returns NULL, HH_GET_LAST_ERROR may not always report an error.