Funzione CreateAcceleratorTableA (winuser.h)

Articolo
08/27/2023

Crea una tabella dell'acceleratore.

Sintassi

HACCEL CreateAcceleratorTableA(
  [in] LPACCEL paccel,
  [in] int     cAccel
);

Parametri

[in] paccel

Tipo: LPACCEL

Matrice di strutture ACCEL che descrive la tabella degli acceleratori.

[in] cAccel

Tipo: int

Numero di strutture ACCEL nella matrice. Deve essere compreso nell'intervallo compreso tra 1 e 32767 oppure la funzione avrà esito negativo.

Valore restituito

Tipo: HACCEL

Se la funzione ha esito positivo, il valore restituito è l'handle per la tabella di acceleratore creata; in caso contrario, è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Prima della chiusura di un'applicazione, può usare la funzione DestroyAcceleratorTable per eliminare tutte le tabelle di acceleratore create tramite la funzione CreateAcceleratorTable .

Esempio

Per un esempio, vedere Creazione di acceleratori modificabili dall'utente.

Nota

L'intestazione winuser.h definisce CreateAcceleratorTable 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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