Funzione LoadAcceleratorsA (winuser.h)

Articolo
11/20/2024

Carica la tabella dell'acceleratore specificata.

Sintassi

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

Parametri

[in, optional] hInstance

Tipo: HINSTANCE

Handle del modulo il cui file eseguibile contiene la tabella dell'acceleratore da caricare.

[in] lpTableName

Tipo: LPCTSTR

Nome della tabella dell'acceleratore da caricare. In alternativa, questo parametro può specificare l'identificatore di risorsa di una risorsa di tabella dell'acceleratore nella parola con ordine basso e zero nella parola di ordine elevato. Per creare questo valore, utilizzare 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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

Le tabelle acceleratori caricate dalle risorse vengono liberate automaticamente quando l'applicazione termina.

Esempi

Per un esempio, vedere Creating Accelerators for Font Attributes.

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll