Inscription d’un élément de menu contextuel statique

Les composants logiciels enfichables MMC administratifs de services de domaine Active Directory et l’interpréteur de commandes Windows fournissent un mécanisme permettant d’ajouter un élément au menu contextuel affiché pour les objets dans services de domaine Active Directory. Le menu contextuel peut appeler n’importe quel fichier qui peut être démarré avec l’API ShellExecute , comme une URL d’application ou de page web.

Inscription auprès de services de domaine Active Directory

L’inscription de l’extension de menu contextuel est spécifique à un paramètre régional. Si l’extension de menu contextuel s’applique à tous les paramètres régionaux, elle doit être inscrite dans l’objet displaySpecifier de la classe d’objet dans tous les sous-conteneurs régionaux du conteneur Display Specifiers. Si l’extension de menu contextuel est localisée pour certains paramètres régionaux, elle doit être inscrite dans l’objet displaySpecifier de ce sous-ensemble de paramètres régionaux. Pour plus d’informations sur le conteneur de spécificateurs d’affichage et les paramètres régionaux, consultez Display Specifiers and DisplaySpecifiers Container.

Un élément de menu contextuel statique peut être inscrit sous deux attributs de spécificateur d’affichage : adminContextMenu et shellContextMenu.

L’attribut adminContextMenu identifie les menus contextuels administratifs à afficher dans les composants logiciels enfichables administratifs de services de domaine Active Directory. Le menu contextuel s’affiche lorsque l’utilisateur affiche le menu contextuel des objets de la classe appropriée dans l’un des composants logiciels enfichables MMC administratifs.

L’attribut shellContextMenu identifie les menus contextuels de l’utilisateur final à afficher dans l’interpréteur de commandes Windows. Le menu contextuel s’affiche lorsque l’utilisateur affiche le menu contextuel des objets de la classe appropriée dans le Explorer Windows. À compter de Windows Server 2003, l’interpréteur de commandes Windows n’affiche plus les objets provenant de services de domaine Active Directory.

Tous ces attributs sont à valeurs multiples.

Lors de l’inscription d’un élément de menu contextuel statique, les valeurs des attributs adminContextMenu et shellContextMenu nécessitent le format suivant.

<order number>,<menu text>,<command>

Le «< numéro> de commande » est un nombre non signé qui représente la position de l’élément dans le menu contextuel. Lorsqu’un menu contextuel s’affiche, les valeurs sont triées à l’aide d’une comparaison du «< numéro> de commande » de chaque valeur. Si plusieurs valeurs ont le même «< numéro> de commande », ces extensions de menu contextuel sont chargées dans l’ordre dans lequel elles sont lues à partir du serveur Active Directory. Si possible, utilisez un «< numéro> de commande » non existant, c’est-à-dire qui n’a pas été utilisé par d’autres valeurs de la propriété. Il n’y a pas de position de départ prescrite, et les intervalles sont autorisés dans la séquence «< numéro de> commande ».

Le «< texte> de menu » est la chaîne affichée dans le menu contextuel. Le «< texte> de menu » peut inclure un caractère «& » qui précède le caractère de raccourci clavier de l’élément de menu. Cela entraîne l’accent sur le caractère précédé. Par exemple, si le «< texte> de menu » est «& Fichier », le texte de menu s’affiche sous la forme « Fichier », le « F » est souligné et « F » est le raccourci clavier de l’élément de menu.

La «< commande> » est le programme ou le fichier exécuté par le composant logiciel enfichable. Le chemin d’accès complet doit être spécifié ou le fichier doit exister dans la variable d’environnement du chemin d’accès de l’ordinateur. Le fichier est appelé à l’aide de la fonction ShellExecute . La «< commande> » ne peut pas contenir de paramètres supplémentaires, par exemple, Notepad.exe Myfile.txt. Étant donné que ShellExecute est utilisé, tout fichier ou adresse qui peut être passé à ShellExecute peut être utilisé pour «< command> ». Par exemple, si «< command> » contient « d:\file.txt », d:\file.txt sera ouvert avec l’application associée à l’extension .txt. De même, si «< command> » contient «https://www.fabrikam.com" ; », le navigateur web par défaut est ouvert et affiche la page web spécifiée. Les chemins d’accès et les noms d’application avec des espaces sont autorisés. Si «< command> » est une application, la classe ADsPath et la classe de l’objet sélectionné sont passées en tant qu’arguments de ligne de commande, séparés par un espace.

Dans l’interpréteur de commandes Windows, les éléments de menu contextuel à sélection multiple sont pris en charge. Dans ce cas, la «< commande> » est appelée pour chaque objet sélectionné. Dans les composants logiciels enfichables administratifs de services de domaine Active Directory, les éléments de menu contextuel statique à sélection multiple ne sont pas pris en charge.

Important

Pour l’interpréteur de commandes Windows, les données du spécificateur d’affichage sont récupérées lors de l’ouverture de session de l’utilisateur et mises en cache pour la session de l’utilisateur. Pour les composants logiciels enfichables d’administration, les données du spécificateur d’affichage sont récupérées lorsque le composant logiciel enfichable est chargé et mis en cache pendant la durée du processus. Pour l’interpréteur de commandes Windows, cela signifie que les modifications apportées à l’affichage des spécificateurs prennent effet une fois qu’un utilisateur se déconnecte et se reconnecte. Pour les composants logiciels enfichables d’administration, les modifications prennent effet lorsque le fichier de composant logiciel enfichable ou de console est rechargé ; Autrement dit, si vous démarrez une nouvelle instance du fichier console ou de nouvelles Mmc.exe instance et que vous ajoutez le composant logiciel enfichable, les dernières données du spécificateur d’affichage sont récupérées.

 

Pour plus d’informations et un exemple de code, consultez Exemple de code pour l’installation d’un élément de menu contextuel statique.