DestroyMenu-Funktion (winuser.h)

Zerstört das angegebene Menü und gibt den Arbeitsspeicher frei, den das Menü belegt.

Syntax

BOOL DestroyMenu(
  [in] HMENU hMenu
);

Parameter

[in] hMenu

Typ: HMENU

Ein Handle für das zu zerstörende Menü.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Vor dem Schließen muss eine Anwendung die DestroyMenu-Funktion verwenden, um ein Menü zu zerstören, das einem Fenster nicht zugewiesen ist. Ein Menü, das einem Fenster zugewiesen ist, wird automatisch zerstört, wenn die Anwendung geschlossen wird.

DestroyMenu ist rekursiv, d. h., es zerstört das Menü und alle seine Untermenüs.

Beispiele

Ein Beispiel finden Sie unter Anzeigen eines Kontextmenüs.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-menu-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzept

CreateMenu

DeleteMenu

Menüs

Referenz

RemoveMenu

SetMenuItemInfo