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
Referenz