Méthode IWCContextMenuCallback ::AddExtensionMenuItem (cluadmex.h)
[Cette méthode peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. La prise en charge de cette méthode a été supprimée dans Windows Server 2008.]
Ajoute un élément de menu à un menu contextuel Administrateur du cluster de basculement .
Syntaxe
HRESULT AddExtensionMenuItem(
[in] BSTR lpszName,
[in] BSTR lpszStatusBarText,
[in] ULONG nCommandID,
[in] ULONG nSubmenuCommandID,
[in] ULONG uFlags
);
Paramètres
[in] lpszName
Pointeur vers une chaîne Unicode terminée par un caractère Null contenant le nom de l’élément à ajouter au menu. Bien que déclaré en tant que BSTR, ce paramètre est implémenté en tant que LPWSTR.
[in] lpszStatusBarText
Pointeur vers le texte à afficher dans la barre de status lorsque le nouvel élément est sélectionné. Bien que déclaré en tant que BSTR, ce paramètre est implémenté en tant que LPWSTR.
[in] nCommandID
Identificateur de la commande à appeler lorsque l’élément de menu est sélectionné. Le paramètre nCommandID ne doit pas être défini sur –1.
[in] nSubmenuCommandID
Identificateur d’un sous-menu. Les sous-menus ne sont pas pris en charge et le paramètre nSubmenuCommandID doit être égal à zéro.
[in] uFlags
Masque de bits des indicateurs qui décrit le nouvel élément de menu. Une ou plusieurs des valeurs suivantes peuvent être définies.
MF_CHECKED (8)
Agit comme un bouton bascule avec MF_UNCHECKED pour placer la marque de case activée par défaut en regard de l’élément.
MF_UNCHECKED (0)
Agit comme un bouton bascule avec MF_CHECKED pour supprimer une marque case activée placée à côté de l’élément.
MF_DISABLED (2)
Désactive l’élément de menu afin qu’il ne puisse pas être sélectionné, mais ne l’est pas.
MF_ENABLED (0)
Active l’élément de menu afin qu’il puisse être sélectionné et le restaure à partir de son état grisé si l’élément était précédemment grisé.
MF_GRAYED (1)
Désactive l’élément de menu de sorte qu’il ne puisse pas être sélectionné et l’assoima.
MF_MENUBARBREAK (32 (0x20))
Places l’élément dans une nouvelle colonne. La nouvelle colonne est séparée de l’ancienne colonne par une ligne de division verticale.
MF_MENUBREAK (64 (0x40))
Places l’élément dans une nouvelle colonne. Aucune ligne de division n’est placée entre les colonnes.
MF_SEPARATOR (2048 (0x800))
Dessine une ligne de séparation horizontale. Cette ligne ne peut pas être grisée, désactivée ou mise en surbrillance. Les paramètres lpszName et lpszStatusBarText sont ignorés.
MF_STRING (0)
Spécifie que l’élément de menu est une chaîne de caractères. Le paramètre lpszName contient un pointeur vers une chaîne Unicode terminée par NULL. Il s’agit de l’interprétation par défaut.
Valeur retournée
Si AddExtensionMenuItem échoue, il peut retourner d’autres valeurs HRESULT .
| Code/valeur de retour | Description |
|---|---|
|
L'opération a réussi. |
|
Le paramètre uFlags a été défini sur MF_OWNERDRAW ou MF_POPUP. |
|
Une erreur s’est produite lors de l’allocation de l’élément de menu. |
Remarques
La méthode AddExtensionMenuItem ajoute des éléments en haut du menu contextuel et les suit par un séparateur. La commande identifiée par nCommandID est passée dans le paramètre nCommandID à la méthode IWEInvokeCommand ::InvokeCommand lorsque l’utilisateur sélectionne cet élément de menu.
Notez que les indicateurs MF_OWNERDRAW et MF_POPUP ne sont pas pris en charge spécifiquement pour le paramètre uFlags .
Les extensions Administrateur de cluster de basculement appellent AddExtensionMenuItem à partir de leur méthode IWEExtendContextMenu ::AddContextMenuItems.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2003 Entreprise, Windows Server 2003 Datacenter |
| Plateforme cible | Windows |
| En-tête | cluadmex.h |