Users Guide

Sie können die Instanz von IANet_NetService nicht löschen.
Ändern von Eigenschaften
Für diese Klasse sind keine durch den Benutzer veränderbaren Eigenschaften vorhanden.
Unterstützte Attribute
Durch diese Klasse werden zwei Attribute implementiert:
Version – Enthält die aktuelle Version des Kern-Providers.
InstallDate – Enthält das Datum, an dem die Provider installiert wurden.
Methoden
Die folgenden Methoden können zur Verwaltung von Sitzungen verwendet werden:
void GetSessionHandle(([OUT] string SessionHandle, [out] uint32 ActiveSessions) – Dient zum Einstellen einer
Handle-Zeichenfolge für die Sitzung. Diese Zeichenfolge sollte im Kontextobjekt im SessionHandle-Qualifizierungsmerkmal
platziert werden. ActiveSessions gibt die Anzahl der aktiven Sitzungen für dieses System zurück. Dadurch ist es möglich,
Clients davor zu warnen, dass andere Benutzer eventuell die Netzwerkeinstellungen ändern.
void Apply([IN] string sSessionHandle, [OUT] uint32 FollowupAction); – Wendet Änderungen an, die mit einem
speziellen Sitzungshandle durchgeführt wurden. Das zurückgegebene uint32-Argument wird von den WMI und CDM
Providern verwendet, um der Anwendung mitzuteilen, dass ein Serverneustart erforderlich ist, bevor die Änderungen
wirksam werden. Dies wird durch Aufrufen der Reboot-Methode (Neustart) für die Klasse Win32_OperatingSystem erreicht.
Werte:
1 = Systemneustart erforderlich
0 = Kein Neustart erforderlich
void ReleaseSessionHandle ([IN] string SessionHandle) – Gibt ein Sitzungshandle nach der Verwendung frei. Alle
Änderungen, die bei dieser Sitzung durchgeführt wurden, gehen verloren. Das Sitzungshandle ist nach diesem Aufruf nicht
mehr gültig und kann nicht mehr verwendet werden.
void Cancel([IN] string SessionHandle); – Bricht eine Sitzung ab. Der interne Cache-Speicher wird gelöscht, und alle
nach diesem Aufruf gelesenen Daten zeigen die aktuelle Konfiguration.
Zurück zum Seitenanfang
Kernereignisse
IANet_SessionEvent
Zweck
Dieses Ereignis wird verwendet, um den Client über die Verwendung der NCS-Sitzungs-API zu informieren. Clients können dieses
Ereignis verwenden, um darüber informiert zu werden, wenn andere Clients Sitzungen erstellen oder verwenden.
Auslöser
Dieses Ereignis wird ausgelöst, wenn ein Client eine Sitzung erstellt, löscht oder Apply (Übernehmen) für eine Sitzung aufruft.
Ereignisdaten
Als EventType (Ereignistyp) kommt einer der folgenden Werte infrage:
"New session" (Neue Sitzung) weist darauf hin, dass eine neue Sitzung durch den Client oder einen anderen Client erstellt
wurde.
"End session" (Ende der Sitzung) weist darauf hin, dass ein Client eine Sitzung beendet hat. Die Sitzung kann vom Client
oder einem anderen Client beendet worden sein.
"Cache invalidated" (Cache ungültig) weist darauf hin, dass ein anderer Client den Aufruf Apply (Übernehmen) auf eine
Sitzung angewendet hat. Alle anderen Sitzungen verlieren dadurch ihre Gültigkeit und der mit ihren Sitzungen assoziierte
Cache wird gelöscht.
"Configuration changed" (Konfiguration geändert) weist darauf hin, dass die Konfiguration der Sitzung sich geändert hat.
Als SessionHandle (Sitzungshandle) wird das Sitzungshandle angezeigt, das das Ereignis ausgelöst hat.
22