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.

Werte:

  • TRUE (WAHR) = Provider führt den Vorgang nicht aus, aber gibt einen Fehlercode und den erweiterten Status zurück, falls der Vorgang nicht erlaubt ist.
  • FALSE (FALSCH) = Provider führt den Vorgang aus.

Das Fehlen dieses Qualifizierungsmerkmals wird so interpretiert, als ob das Attribut FALSE (FALSCH) wäre.

WarningErrorCode VT_I4 Bei einigen Vorgängen ist es unter Umständen notwendig, Warnungen an den Benutzer zu senden (beim Hinzufügen eines Adapters muss eine Gruppe z. B. unter gewissen Umständen neu geladen werden). WMI bietet keinen Mechanismus für diese Aktion. Wenn dieses Qualifizierungsmerkmal vorhanden und nicht gleich null ist, gibt der Provider E_FAIL zurück, sofern der Vorgang zwar gelungen ist, aber eine Warnung damit verbunden ist. Der Client sollte den erweiterten Status verwenden, um den Text jeder Warnung zu sehen.


Lesen Sie bitte alle Einschränkungen und Haftungsausschlüsse.


Zurück zur Inhaltsseite     Zurück zum Seitenanfang