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

Vous ne pouvez pas supprimer des instances de IANet_NetService.
Modification des propriétés
Aucune propriété de cette classe ne peut être modifiée par l'utilisateur.
Attributs pris en charge
Cette classe met en oeuvre deux attributs :
Version — Contient la version actuelle du fournisseur principal.
InstallDate — Contient la date d'installation des fournisseurs.
Méthodes
Les méthodes suivantes peuvent être utilisées pour gérer des sessions :
void GetSessionHandle(([OUT] string SessionHandle, [out] uint32 ActiveSessions) — Utilisé pour définir la chaîne du
descripteur de session qui doit être placée dans l'objet de contexte du qualificateur SessionHandle. ActiveSessions renvoie
le nombre de sessions actives pour ce système. Cela permet aux clients de signaler que d'autres peuvent être en train de
modifier les paramètres réseau.
void Apply([IN] string sSessionHandle, [OUT] uint32 FollowupAction); — Applique les modifications effectuées par un
autre descripteur de session particulier. L'argument uint32 renvoyé est utilisé par les fournisseurs WMI et CDM pour indiquer
à l'application que le serveur doit être redémarré avant que les modifications ne soient prises en compte. Ceci peut être
réalisé en appelant la méthode Reboot sur la classe Win32_OperatingSystem.
Valeurs :
1 = Redémarrage système requis
0 = Redémarrage non requis
void ReleaseSessionHandle ([IN] string SessionHandle) — Émet un descripteur de session après son utilisation. Toute
modification de cette session est alors perdue. Le descripteur de session n'est plus valide après cet appel et il ne peut plus
être utilisé.
void Cancel([IN] string SessionHandle); — Annule une session. La mémoire cache interne est effacée et toutes les
données lues après cet appel affichent la configuration actuelle.
Retour au début de la page
Événements principaux
IANet_SessionEvent
Objectif
Cet événement est utilisé pour avertir le client de l'utilisation de l'API de la session NCS. Les clients peuvent utiliser cet
événement pour recevoir une notification si d'autres clients créent ou utilisent des sessions.
Déclenchement
Cet événement est déclenché lorsqu'un client crée ou supprime une session, ou appelle la méthode Apply pour une session.
Données d'événement
EventType peut avoir l'une des valeurs suivantes :
"New session" (Nouvelle session) indique qu'une nouvelle session a été créée par le client ou un autre client.
"End session" (Session terminée) indique qu'un client a terminé une session. La session a été terminée par le client ou un
autre client.
"Cache invalidated" (Mémoire cache annulée) indique qu'un autre client a appelé la méthode Apply pour une session.
Toutes les autres sessions sont annulées et les mémoires cache associées sont effacées.
"Configuration changed" (Configuration modifiée) indique que la configuration de la session a changé.
SessionHandle contient le descripteur de session qui a déclenché l'événement.
OpenSessions contient le nombre de sessions ouvertes. Cet élément de données est NULL pour les événements "Cache
invalidated" et "Configuration changed".
21