Microsoft KB Archive/69896

PRB: Multikey Help Code Incorrect in Windows Tools Manual ID Number: Q69896

3.00

WINDOWS docerr

Summary:

SYMPTOMS The sample code to access an alternate keyword table in a Windows Help file from an application, provided on page 18-21 in the “Microsoft Windows Software Development Kit Tools” manual for version 3.0 is incorrect.

STATUS/RESOLUTION Microsoft has confirmed that this documentation error occurs on page 18-21 in the “Microsoft Windows Software Development Kit Tools” manual for version 3.0. This error has been corrected on Page 42 of the “Microsoft Windows Software Development Kit Tools” manual for version 3.1. A different example is included on Page 42.

The following is the correct code to access the ‘B’ keyword table in a Windows Help file:

HANDLE hmk; MULTIKEYHELP far *pmk; char szKeyword[] = “B-keyword”;

case MULTIKEY: hmk = GlobalAlloc(GHND, (sizeof(MULTIKEYHELP)+lstrlen(szKeyword))); if (hmk == NULL) break; pmk = (MULTIKEYHELP FAR *)GlobalLock(hmk); pmk -> mkSize = sizeof(MULTIKEYHELP)+lstrlen(szKeyword); pmk -> mkKeylist = ‘B’; lstrcpy(pmk -> szKeyphrase, szKeyword);

WinHelp(hWnd, szHelpFileName, HELP_MULTIKEY, (DWORD)(LPSTR)pmk);

GlobalUnlock(hmk); GlobalFree(hmk);

break; Additional reference words: 3.00 docerr MICS3 T18