LoadAccelerators function

Loads the specified accelerator table.

Syntax


HACCEL WINAPI LoadAccelerators(
  _In_opt_ HINSTANCE hInstance,
  _In_     LPCTSTR   lpTableName
);

Parameters

hInstance [in, optional]

Type: HINSTANCE

A handle to the module whose executable file contains the accelerator table to be loaded.

lpTableName [in]

Type: LPCTSTR

The name of the accelerator table to be loaded. 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. To create this value, use the MAKEINTRESOURCE macro.

Return value

Type: HACCEL

If the function succeeds, the return value is a handle to 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.

Examples

For an example, see Creating Accelerators for Font Attributes.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll
Unicode and ANSI names	LoadAcceleratorsW (Unicode) and LoadAcceleratorsA (ANSI)