OleSetMenuDescriptor-Funktion (ole2.h)
Installiert oder entfernt OLE-Verteilungscode aus dem Framefenster des Containers.
Syntax
HRESULT OleSetMenuDescriptor(
[in] HOLEMENU holemenu,
[in] HWND hwndFrame,
[in] HWND hwndActiveObject,
[in] LPOLEINPLACEFRAME lpFrame,
[in] LPOLEINPLACEACTIVEOBJECT lpActiveObj
);
Parameter
[in] holemenu
Handle mit dem zusammengesetzten Menüdeskriptor, der von der OleCreateMenuDescriptor-Funktion zurückgegeben wird. Bei NULL wird der Verteilungscode aufgehoben.
[in] hwndFrame
Handle mit dem Framefenster des Containers, in dem das direkte zusammengesetzte Menü installiert werden soll.
[in] hwndActiveObject
Handle mit dem direkten Aktivierungsfenster des Objekts. OLE sendet Menümeldungen und Befehle an dieses Fenster.
[in] lpFrame
Zeiger auf die IOleInPlaceFrame-Schnittstelle im Rahmenfenster des Containers.
[in] lpActiveObj
Zeiger auf die IOleInPlaceActiveObject-Schnittstelle für das aktive direkte Objekt.
Rückgabewert
Diese Funktion gibt bei Erfolg S_OK zurück.
Hinweise
Der Container sollte OleSetMenuDescriptor aufrufen, um den Verteilercode auf hwndFrame zu installieren, wenn das Objekt die IOleInPlaceFrame::SetMenu-Methode aufruft, oder um den Verteilercode zu entfernen, indem NULL als Wert für holemenu an OleSetMenuDescriptor übergeben wird.
Wenn sowohl die Parameter lpFrame als auch lpActiveObj nicht NULL sind, installiert OLE den kontextabhängigen Hilfe-F1-Nachrichtenfilter für die Anwendung. Andernfalls muss die Anwendung einen eigenen Nachrichtenfilter bereitstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ole2.h |
| Bibliothek | Ole32.lib |
| DLL | Ole32.dll |
| APIs | ext-ms-win-com-ole32-l1-1-5 (eingeführt in Windows 10, Version 10.0.15063) |