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.

Si ce qualificateur est manquant, l'attribut est considéré comme étant FALSE.

WarningErrorCode VT_I4 Certaines opérations requièrent l'envoi d'avertissements à l'utilisateur (p. ex., l'ajout d'une carte à une association peut nécessiter le rechargement de l'association dans certains cas). WMI ne fourni aucun mécanisme pour cela. Si ce qualificateur est présent et différent de zéro, le fournisseur renvoie E_FAIL si l'opération a réussi mais avec un avertissement. Le client doit consulter l'état détaillé pour obtenir le texte de l'avertissement.


Veuillez lire toutes les restrictions et clauses exonératoires de responsabilité.


Retour à la table des matières    Retour au début de la page