Prev Next

LoadAccelerators info  Overview  Group

The LoadAccelerators function loads the specified accelerator table.

HACCEL LoadAccelerators(

    HINSTANCE hInstance,

// handle of application instance

    LPCTSTR lpTableName 

// address of table-name string

   );

Parameters

hInstance
Identifies an instance of the module whose executable file contains the accelerator table to load.
lpTableName
Points to a null-terminated string that names the accelerator table to load. Alternatively, this parameter can specify the resource identifier of an accelerator-table resource in the low-order word and zero in the high-order word. The MAKEINTRESOURCE macro can be used to create this value.

Return Values

If the function succeeds, the return value is the handle of the loaded accelerator table.

If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

If the accelerator table has not yet been loaded, the function loads it from the specified executable file.

Accelerator tables loaded from resources are freed automatically when the application terminates.

See Also

CopyAcceleratorTable, CreateAcceleratorTable, DestroyAcceleratorTable, MAKEINTRESOURCE