Dell Intel PRO Family of Adapters - Manuel (Page 12)

Retour à la table des matières
Espace de noms et contexte : Guide de l'utilisateur des
fournisseurs WMI et CDM pour cartes réseau Intel® PRO
Les classes CIM résident dans un espace de noms. L'espace de noms standard de Microsoft* est appelé root/cimv2 et est basé
sur CIM v2.2 ou sur root/défaut. Les classes des fournisseurs WMI et CDM peuvent être ajoutées à cet espace de noms. Les
fournisseurs sont basés sur CIM v2.5. En raison de cela et des différences utilisées dans les clés des objets, les classes des
fournisseurs sont situées dans un espace de noms séparé, root/IntelNCS.
Contexte WBEM
Les objets de contexte offrent des informations supplémentaires aux fournisseurs qui ne peuvent être transmises en tant que
paramètre à une méthode API WMI. Pour enregistrer les qualificateurs de contexte, utilisez IWbemContext. L'indicateur d'interface
pour l'objet de contexte est transmis en tant que dernier paramètre d'une méthode IWbemServices.
La table suivante contient les qualificateurs de contexte (valeurs nommées) utilisés par les fournisseurs. La plupart des
qualificateurs, comme SessionHandle par exemple, ne sont utilisés qu'en conjonction avec des zones fonctionnelles spécifiques des
fournisseurs, alors que LocaleID, MachineName et ApplicationName peuvent être définis pour tous les appels IWbemServices.
Si aucun contexte n'est passé aux fournisseurs, ils utilisent le LocaleID passé lors de l'appel Initialize aux fournisseurs. Toute
lecture effectuée dans un contexte lit la configuration actuelle jusqu'à ce qu'une opération d'écriture soit réalisée. Les lectures
suivantes affichent le système tel qu'il serait une fois l'opération d'écriture réussie. Un contexte NULL peut être utilisé pour les
lectures.
Qualificateur de
contexte Type de
variante Description
SessionHandle VT_BSTR Identifie la copie des classes réseau IANet de l'application. L'application ne peut modifier les
classes ou leurs attributs sans d'abord établir un descripteur de session. Reportez-vous à la
section relative à la classe IANet_NetService pour savoir comment établir et utiliser un
descripteur de session. Ce qualificateur n'est pas requis si l'application ne fait que lire les
données des classes. Le descripteur de session permet au logiciel NCS de gérer plusieurs
accès simultanés à la configuration, empêchant ainsi à la session de bloquer l'accès à tous les
autres. Chaque session possède une mémoire cache séparée qui stocke toutes les
modifications effectuées. Si plusieurs utilisateurs apportent des modifications simultanément, le
premier utilisateur qui applique ses modifications prime. Les mémoires cache de tous les autres
utilisateurs seront annulées.
LocaleID VT_BSTR ID de Microsoft pour des paramètres régionaux. Ce qualificateur est requis si l'application
requiert des chaînes de texte localisées des fournisseurs. Tous les messages d'erreur et les
avertissements seront en anglais, sauf si le LocaleID requis est utilisé.
ApplicationName VT_BSTR Le nom de l'application qui a lancé l'appel. Ce qualificateur est nécessaire pour la consignation.
MachineName VT_BSTR Le nom de l'ordinateur qui est connecté aux fournisseurs. Ce qualificateur est nécessaire pour
la consignation.
PreCheck VT_BOOL Cette valeur booléenne est utilisée pour signaler aux fournisseurs que le client essaie de
vérifier si oui ou non une opération est autorisée avant de l'exécuter. Par exemple, l'ajout d'une
carte à une association.
Valeurs :
TRUE = Le fournisseur n'exécute pas l'opération mais renvoie un code d'erreur et un
état détaillé si l'opération n'est pas autorisée.
FALSE = Le fournisseur exécute l'opération.
12