Funzione LoadAcceleratorsA (winuser.h)

Articolo
03/15/2023

Carica la tabella di acceleratore specificata.

Sintassi

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

Parametri

[in, optional] hInstance

Tipo: HINSTANCE

Handle al modulo il cui file eseguibile contiene la tabella acceleratore da caricare.

[in] lpTableName

Tipo: LPCTSTR

Nome della tabella acceleratore da caricare. In alternativa, questo parametro può specificare l'identificatore di risorsa di una risorsa di tabella acceleratore nella parola a basso ordine e zero nella parola ad ordine elevato. Per creare questo valore, usare la macro MAKEINTRESOURCE .

Valore restituito

Tipo: HACCEL

Se la funzione ha esito positivo, il valore restituito è un handle per la tabella dell'acceleratore caricata.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se la tabella acceleratore non è ancora stata caricata, la funzione lo carica dal file eseguibile specificato.

Le tabelle di acceleratore caricate dalle risorse vengono liberate automaticamente al termine dell'applicazione.

Esempio

Per un esempio, vedere Creazione di acceleratori per attributi di carattere.

Nota

L'intestazione winuser.h definisce LoadAccelerators come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll