IWCContextMenuCallback::AddExtensionMenuItem-Methode (cluadmex.h)
[Diese Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Die Unterstützung für diese Methode wurde in Windows Server 2008 entfernt.]
Fügt einem Kontextmenü des Failoverclusteradministrators ein Menüelement hinzu.
Syntax
HRESULT AddExtensionMenuItem(
[in] BSTR lpszName,
[in] BSTR lpszStatusBarText,
[in] ULONG nCommandID,
[in] ULONG nSubmenuCommandID,
[in] ULONG uFlags
);
Parameter
[in] lpszName
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Termin, die den Namen des Elements enthält, das dem Menü hinzugefügt werden soll. Obwohl dieser Parameter als BSTR deklariert ist, wird er als LPWSTR implementiert.
[in] lpszStatusBarText
Zeiger auf Text, der auf der status leiste angezeigt werden soll, wenn das neue Element ausgewählt wird. Obwohl dieser Parameter als BSTR deklariert ist, wird er als LPWSTR implementiert.
[in] nCommandID
Bezeichner für den Befehl, der aufgerufen werden soll, wenn das Menüelement ausgewählt wird. Der Parameter nCommandID darf nicht auf –1 festgelegt werden.
[in] nSubmenuCommandID
Bezeichner für ein Untermenü. Untermenüs werden nicht unterstützt, und der Parameter nSubmenuCommandID muss null sein.
[in] uFlags
Bitmaske von Flags, die das neue Menüelement beschreibt. Mindestens einer der folgenden Werte kann festgelegt werden.
MF_CHECKED (8)
Fungiert als Umschaltfläche mit MF_UNCHECKED , um das Standard-Häkchen neben dem Element zu platzieren.
MF_UNCHECKED (0)
Fungiert als Umschaltfläche mit MF_CHECKED , um ein Häkchen neben dem Element zu entfernen.
MF_DISABLED (2)
Deaktiviert das Menüelement, sodass es nicht ausgewählt werden kann, aber nicht abgeblendet wird.
MF_ENABLED (0)
Aktiviert das Menüelement, damit es ausgewählt werden kann, und stellt es aus dem abgeblendeten Zustand wieder her, wenn das Element zuvor abgeblendet wurde.
MF_GRAYED (1)
Deaktiviert das Menüelement, sodass es nicht ausgewählt werden kann, und dimmt es.
MF_MENUBARBREAK (32 (0x20))
Places das Element in einer neuen Spalte. Die neue Spalte wird durch eine vertikale Trennlinie von der alten Spalte getrennt.
MF_MENUBREAK (64 (0x40))
Places das Element in einer neuen Spalte. Zwischen den Spalten wird keine Trennlinie platziert.
MF_SEPARATOR (2048 (0x800))
Zeichnet eine horizontale Trennlinie. Diese Zeile kann nicht abgeblendet, deaktiviert oder hervorgehoben werden. Die Parameter lpszName und lpszStatusBarText werden ignoriert.
MF_STRING (0)
Gibt an, dass das Menüelement eine Zeichenfolge ist. Der parameter lpszName enthält einen Zeiger auf eine MIT NULL beendete Unicode-Zeichenfolge. Dies ist die Standardinterpretation.
Rückgabewert
Wenn AddExtensionMenuItem nicht erfolgreich ist, kann es andere HRESULT-Werte zurückgeben.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der uFlags-Parameter wurde entweder auf MF_OWNERDRAW oder MF_POPUP festgelegt. |
|
Beim Zuweisen des Menüelements ist ein Fehler aufgetreten. |
Hinweise
Die AddExtensionMenuItem-Methode fügt Elemente oben im Kontextmenü hinzu und folgt ihnen durch ein Trennzeichen. Der durch nCommandID identifizierte Befehl wird im nCommandID-Parameter an die IWEInvokeCommand::InvokeCommand-Methode übergeben, wenn der Benutzer dieses Menüelement auswählt.
Beachten Sie, dass die flags MF_OWNERDRAW und MF_POPUP nicht speziell für den uFlags-Parameter unterstützt werden.
Failoverclusteradministratorerweiterungen rufen AddExtensionMenuItem über die IWEExtendContextMenu::AddContextMenuItems-Methode auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 Enterprise, Windows Server 2003 Datacenter |
| Zielplattform | Windows |
| Kopfzeile | cluadmex.h |