Users Guide

OpenSessions (Offene Sitzungen) enthält die Anzahl der geöffneten Sitzungen. Dieses Datenelement ist NULL für die Ereignisse
"Cache invalidated" (Cache ungültig) und "Configuration changed" (Konfiguration geändert).
IANet_InternalErrorEvent
Zweck
Dieses Ereignis wird verwendet, um den Client darüber zu informieren, dass in den Ereignis-Providern ein interner Fehler
aufgetreten ist. In manchen Fällen bedeutet dies, dass der Ereignis-Provider nicht in der Lage ist, weitere Ereignisse zu melden.
Auslöser
Dieses Ereignis tritt in folgenden Situationen ein:
Nachdem der Ereignis-Provider ein unbekanntes Ereignis von einer Ereignisquelle erhält
Nachdem die Software, die die Ereignisse bereitstellt, beendet wurde
Nachdem der Ereignis-Provider ein Ereignis erhalten hat, zu dem die Ereignisquelle keine weiteren Daten ermitteln kann
Ereignisdaten
Als EventType (Ereignistyp) kommt eine der folgenden Angaben infrage:
"Could not get event data" (Konnte Ereignisdaten nicht ermitteln). Ein Ereignis ist eingetreten, aber die Ereignisquelle kann
keine weiteren Daten zum Ereignis ermitteln.
"Event source has shut down" (Ereignisquelle wurde geschlossen). Die Datenquelle für das Ereignis wurde geschlossen. In
diesem Fall wird der Ereignis-Provider ebenfalls geschlossen, und weitere Ereignisse werden erst dann wieder generiert,
wenn die Quelle neu gestartet wurde und neue Benachrichtigungsabfragen durchgeführt wurden.
"Unexpected message" (Unerwartete Meldung). Der Ereignis-Provider hat ein unerwartetes Ereignis erhalten.
Zurück zum Seitenanfang
Verwendungsfälle
Zur Änderung der Konfiguration ist ein Sitzungshandle erforderlich. Mit dem Sitzungshandle ist die NCS-Software in der Lage, den
gleichzeitigen mehrfachen Zugang zur Konfiguration zu verwalten. Dadurch wird verhindert, dass eine Sitzung alle anderen
Sitzungen "aussperrt". Jede Sitzung verwendet einen anderen Cache, um die durchgeführten Änderungen zu speichern. Wenn von
mehreren Sitzungen gleichzeitig Änderungen durchgeführt werden, ist die Sitzung erfolgreich, deren Änderungen zuerst
übernommen werden. Alle anderen Sitzungs-Caches werden dadurch ungültig.
Ermitteln eines Sitzungshandle
Der Client muss vor dem Zugriff auf das Sitzungshandle den Objektpfad der Einzelinstanz von IANet_NetService ermitteln. Rufen
Sie IWbemServices::CreateInstanceEnum auf, und geben Sie den Namen der Klasse weiter: IANet_NetService. Dies entspricht
dem Aufrufen von IWbemServices::ExecQuery mit der Abfrage SELECT * FROM IANet_NetService. Bevor Änderungen
durchgeführt werden können, muss der Client ein Sitzungshandle ermitteln. Verwenden Sie die Methode GetSesssionHandle, um
eine neue Sitzung zu starten.
Der Client kann IWbemServices::ExecMethod verwenden, um eine Methode auf ein CIM-Objekt anzuwenden. Er benötigt dazu
den Objektpfad aus dem __PATH-Attribut der IANet_NetService-Instanz. Bei dieser Methode wird auch die Anzahl der zurzeit
aktiven Sitzungen zurückgegeben. Der Client gibt unter Umständen eine Warnung aus, wenn er keinen exklusiven Zugriff auf den
Netzwerkkonfigurationsservice (NCS) hat.
Verwenden eines Sitzungshandle im IWbemContext-Objekt
Nachdem der Client ein Sitzungshandle erhalten hat, muss er ein IWbemContext-Objekt erstellen. Das Sitzungshandle sollte im
SessionHandle-Qualifizierungsmerkmal dieses Objekts gespeichert werden. Ein Verweis auf dieses COM-Objekt sollte an jeden
an IWbemServices gerichteten Aufruf übertragen werden. Das Sitzungshandle ist nicht erforderlich, wenn Aufrufe für den Zugriff auf
das IANet_NetService-Objekt ausgeführt werden, da dabei das Handle als explizites Argument verwendet wird.
Lesen von anstehenden Änderungen mithilfe eines Sitzungshandle
23