Функция LoadAcceleratorA (winuser.h)

Статья
11/20/2024

Загружает указанную таблицу акселераторов.

Синтаксис

HACCEL LoadAcceleratorsA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpTableName
);

Параметры

[in, optional] hInstance

Тип: HINSTANCE

Дескриптор модуля, исполняемый файл которого содержит таблицу ускорителей для загрузки.

[in] lpTableName

Тип: LPCTSTR

Имя загружаемой таблицы акселератора. Кроме того, этот параметр может указать идентификатор ресурса ресурса акселератора таблицы в слове с низким порядком и ноль в слове с высоким порядком. Чтобы создать это значение, используйте макрос MAKEINTRESOURCE.

Возвращаемое значение

Тип: HACCEL

Если функция выполнена успешно, возвращаемое значение является дескриптором для загруженной таблицы акселератора.

Если функция завершается ошибкой, возвращаемое значение равно NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Если таблица акселератора еще не загружена, функция загружает ее из указанного исполняемого файла.

Таблицы акселератора, загруженные из ресурсов, автоматически освобождаются при завершении работы приложения.

Примеры

Пример см. в разделе создание акселераторов для атрибутов шрифта.

Заметка

Заголовок winuser.h определяет LoadAccelerator как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll