IExtendContextMenu::Command-Methode (mmc.h)

Artikel
02/29/2024

Die IExtendContextMenu::Command-Methode wird aufgerufen, wenn anschließend eines der Elemente ausgewählt wird, die Sie dem Kontextmenü mit IExtendContextMenu::AddMenuItems hinzugefügt haben. MMC ruft Command mit der angegebenen Befehls-ID und einem weiteren Zeiger auf dieselbe IDataObject-Schnittstelle auf.

Syntax

HRESULT Command(
  [in] long         lCommandID,
  [in] LPDATAOBJECT piDataObject
);

Parameter

[in] lCommandID

Ein -Wert, der den Befehlsbezeichner des Menüelements angibt.

[in] piDataObject

Ein Zeiger auf die IDataObject-Schnittstelle des Objekts, dessen Kontextmenü angezeigt wurde.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

MMC reserviert befehls-IDs mit negativem Wert für vordefinierte Menübefehls-IDs, die an die IExtendContextMenu::Command-Methode eines Snap-Ins gesendet werden. Die Befehls-ID –1 ist der in mmc.h definierte MMCC_STANDARD_VIEW_SELECT Enumeratorwert. Dies wird an IExtendContextMenu::Command gesendet, wenn der Benutzer im Menü Ansicht (Groß, Klein, Liste oder Detail) auf einen Standardansichtsbefehl klickt. Dadurch wird das Snap-In benachrichtigt, dass der Benutzer von einer benutzerdefinierten Ansicht (OCX, HTML) abweicht. Nach dem Abrufen eines MMCC_STANDARD_VIEW_SELECT-Befehls sollte das Snap-In beim nächsten Aufruf der IComponent::GetResultViewType-Methode eine Standardansicht anfordern und erst dann eine benutzerdefinierte Ansicht anfordern, bis eines der Menüelemente der benutzerdefinierten Ansicht ausgewählt ist. Wenn das Snap-In nur Standardansichten oder nur benutzerdefinierte Ansichten verwendet, kann der Befehl MMCC_STANDARD_VIEW_SELECT ignoriert werden.

MMC sendet das Snap-In den Befehl MMCC_STANDARD_VIEW_SELECT, wenn der Benutzer auf der Symbolleiste auf die Schaltfläche Zurück klickt. MMC verwendet diesen Befehl, um das Snap-In anzuweisen, die vorherige Ansicht des Ergebnisbereichs anzuzeigen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	mmc.h