Users Guide

Zurück zur Inhaltsseite
Namespace und Kontext: Benutzerhandbuch für Intel® PRO
Netzwerkadapter – WMI und CDM Provider
Die CIM-Klassen befinden sich in einem Namespace. Der reguläre Microsoft* Namespace lautet root/cimv2 und beruht auf CIM
v2.2 oder root/default. Die Klassen von WMI und CDM Provider können diesem Namespace hinzugefügt werden. Die Provider
beruhen auf CIM v2.5. Aus diesem Grund und aufgrund der Unterschiede in den Schlüsseln befinden sich die Provider-Klassen in
dem separaten Namespace root/IntelNCS.
WBEM-Kontext
Kontextobjekte bieten zusätzliche Informationen zu den Providern, die nicht als Parameter an eine WMI API-Methode geleitet
werden können. Verwenden Sie IWbemContext, um Kontext-Qualifizierungsmerkmale zu registrieren. Der Schnittstellenpointer für
das Kontextobjekt wird als der letzte Parameter einer IWbemServices-Methode weitergegeben.
Die folgende Tabelle enthält die Kontext-Qualifizierungsmerkmale (bezeichnete Werte), die von den Providern verwendet werden.
Die meisten Qualifizierungsmerkmale, wie z. B. SessionHandle, werden nur in Verbindung mit speziellen funktionalen Bereichen
der Provider verwendet. LocaleID, MachineName und ApplicationName können dagegen für alle IWbemServices-Aufrufe
eingestellt werden.
Wenn kein Kontext an die Provider weitergegeben wird, verwenden sie die LocaleID, die im Initialize-Aufruf der Provider
weitergegeben wurde. Jeder mit einem Kontext ausgeführte Lesevorgang erfasst die aktuelle Konfiguration bis zu dem Zeitpunkt,
an dem ein Schreibvorgang ausgeführt wird. Nachfolgende Lesevorgänge zeigen das System so, wie es nach dem erfolgreichen
Schreibvorgang aussehen würde. Ein NULL-Kontext kann für Lesevorgänge verwendet werden.
Kontext-
Qualifizierungsmerkmale
Variantentyp
Beschreibung
SessionHandle VT_BSTR Identifiziert die Kopie der IANet-Netzwerkklassen, die die Anwendung verwendet. Die
Anwendung kann keine Änderungen an den Klassen oder ihren Attributen
durchführen, ohne zuerst ein Sitzungshandle einzurichten. Im Abschnitt über die
IANet_NetService-Klasse erfahren Sie, wie ein Sitzungshandle eingerichtet und
verwendet wird. Dieses Qualifizierungsmerkmal ist nicht erforderlich, wenn die
Anwendung die Daten aus den Klassen nur liest. Mit dem Sitzungshandle ist die
NCS-Software in der Lage, den gleichzeitigen mehrfachen Zugang zur Konfiguration
zu verwalten, ohne dass ein Benutzer alle anderen Benutzer "aussperrt". Jede
Sitzung verwendet einen anderen Cache, um die durchgeführten Änderungen zu
speichern. Wenn von mehreren Benutzern gleichzeitig Änderungen durchgeführt
werden, ist der Benutzer erfolgreich, dessen Änderungen zuerst übernommen
werden. Alle anderen Benutzer-Caches werden dadurch ungültig.
LocaleID VT_BSTR Microsoft ID für einen Standort. Dieser Wert ist erforderlich, wenn für die Anwendung
lokalisierte Textzeichenfolgen von den Providern notwendig sind. Alle
Fehlermeldungen und Warnungen werden in Englisch angezeigt, es sei denn, die
erforderliche LocaleID wird verwendet.
ApplicationName VT_BSTR Der Name der Anwendung die den Aufruf ausgeführt hat. Diese Angabe ist für das
Protokoll erforderlich.
MachineName VT_BSTR Der Name der Maschine, die die Verbindung zu den Providern herstellt. Diese
Angabe ist für das Protokoll erforderlich.
PreCheck VT_BOOL Dieser Boolsche Wert wird verwendet, um den Providern mitzuteilen, dass der Client
vor dem Ausführen eines Vorgangs zu überprüfen versucht, ob dieser Vorgang
zulässig ist. Ein solcher Vorgang ist beispielsweise das Hinzufügen eines Adapters
zu einer Gruppe.
13