CreateAcceleratorTableA-Funktion (winuser.h)

Artikel
11/20/2024

Erstellt eine Zugriffstastentabelle.

Syntax

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

Parameter

[in] paccel

Typ: LPACCEL

Ein Array von ACCEL- Strukturen, die die Zugriffstastentabelle beschreiben.

[in] cAccel

Typ: int

Die Anzahl der ACCEL- Strukturen im Array. Dies muss innerhalb des Bereichs 1 bis 32767 liegen, oder die Funktion schlägt fehl.

Rückgabewert

Typ: HACCEL-

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Handle für die erstellte Zugriffstastentabelle; andernfalls ist es NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Bevor eine Anwendung geschlossen wird, kann sie die DestroyAcceleratorTable--Funktion verwenden, um alle Zugriffstastentabellen zu zerstören, die sie mithilfe der CreateAcceleratorTable--Funktion erstellt hat.

Beispiele

Ein Beispiel finden Sie unter Erstellen von bearbeitbaren Zugriffstasten.

Anmerkung

Der winuser.h-Header definiert CreateAcceleratorTable als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll