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

IANet_InternalErrorEvent
Objectif
Cet événement est utilisé pour avertir le client qu'une erreur interne est survenue dans les fournisseurs d'événements. Dans
certains cas, cela signifie que le fournisseur d'événements ne peut plus signaler les événements.
Déclenchement
Cet événement se produit :
lorsque le fournisseur d'événements reçoit un événement inconnu d'une source d'événements ;
lorsque le logiciel qui fournit les événements est arrêté ;
lorsque le fournisseur d'événements reçoit un événement, mais que la source d'événements ne peut obtenir des données
supplémentaires sur celui-ci.
Données d'événement
EventType peut avoir l'une des valeurs suivantes :
"Could not get event data" (Impossible d'obtenir les données liées à l'événement). Un événement se produit, mais la source
d'événements ne peut obtenir des données supplémentaires sur celui-ci.
"Event source has shut down" (La source d'événements a été fermée). La source de données de l'événement a été fermée.
Dans ce cas, le fournisseur d'événements est également fermé et aucun autre événement n'est généré tant que la source
n'est pas redémarrée et que des nouvelles requêtes de notification sont faites.
"Unexpected message" (Message inattendu). Le fournisseur d'événements a reçu un type d'événement inattendu.
Retour au début de la page
Cas d'emploi
Un descripteur de session est requis pour modifier la configuration. 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 sessions effectuent des
modifications simultanément, la première session qui applique ses modifications prime. Les mémoires cache de toutes les autres
sessions sont annulées.
Obtention d'un descripteur de session
Le client doit obtenir le chemin d'accès à l'objet d'une instance unique de IANet_NetService avant d'accéder au descripteur de
session. Appelez IWbemServices::CreateInstanceEnum et passez le nom de la classe : IANet_NetService. Ceci revient à appeler
IWbemServices::ExecQuery avec la requête SELECT * FROM IANet_NetService. Avant de modifier la configuration, le client
doit obtenir un descripteur de session. Utilisez la méthode GetSesssionHandle pour démarrer une nouvelle session.
Le client peut utiliser IWbemServices::ExecMethod pour exécuter une méthode sur un objet CIM, et doit obtenir le chemin de
l'objet à partir de l'attribut __PATH de l'instance de IANet_NetService. Cette méthode renvoie également le nombre de sessions
actives en cours. Le client peut émettre un avertissement s'il n'a pas un accès exclusif au service de configuration réseau (NCS).
Utilisation d'un descripteur de session dans l'objet IWbemContext
Lorsque le client a obtenu un descripteur de session, il doit créer un objet IWbemContext. Stockez le descripteur de session dans
le qualificateur SessionHandle de cet objet. Un indicateur de cet objet COM doit être passé à chaque appel dans IWbemServices.
Le descripteur de session n'est pas requis pour les appels d'accès à l'objet IANet_NetService car il traite le descripteur comme un
argument explicite.
Lecture des modifications en attente en utilisant un descripteur de session
Si vous passez un descripteur de session dans le contexte lors de la lecture de la configuration, les fournisseurs renvoient la
configuration telle qu'elle serait si les mises à jour avaient été appliquées (p. ex. les cartes désinstallées sont manquantes et les
22