LoadMenuIndirectA-Funktion (winuser.h)

2024-11-20

Lädt die angegebene Menüvorlage im Arbeitsspeicher.

Syntax

HMENU LoadMenuIndirectA(
  [in] const MENUTEMPLATEA *lpMenuTemplate
);

Parameter

[in] lpMenuTemplate

Typ: const MENUTEMPLATE*

Ein Zeiger auf eine Menüvorlage oder eine erweiterte Menüvorlage. Eine Menüvorlage besteht aus einer MENUITEMTEMPLATEHEADER- Struktur gefolgt von einer oder mehreren zusammenhängenden MENUITEMTEMPLATE Strukturen. Eine erweiterte Menüvorlage besteht aus einer MENUEX_TEMPLATE_HEADER Struktur, gefolgt von einer oder mehreren zusammenhängenden MENUEX_TEMPLATE_ITEM Strukturen.

Rückgabewert

Typ: HMENU

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das Menü.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Sowohl für die ANSI- als auch für die Unicode-Version dieser Funktion müssen die Zeichenfolgen in der MENUITEMTEMPLATE- Struktur Unicode-Zeichenfolgen sein.

Anmerkung

Der winuser.h-Header definiert LoadMenuIndirect als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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