LoadAccelerators

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function loads the specified accelerator table.

HACCEL
LoadAccelerators(
HINSTANCE
hInstance
,
LPCTSTR
lpTableName
);

Parameters

hInstance

Handle to an instance of the module whose executable file contains the accelerator table to load.

lpTableName

Long pointer 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 MAKEINTRESOURCEmacro can be used to create this value.

Return Values

The handle to the loaded accelerator table indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

The resource is not copied into RAM, so it may not be modified.

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.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Winuser.h		Accel.lib

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.