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.
A version of this page is also available for
4/8/2010

This function loads the specified accelerator table.

Syntax 

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 Value

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

Header winuser.h
Library Accel.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also