Zurück zur Inhaltsseite

Aktualisieren der Konfiguration: Benutzerhandbuch für Intel® PRO Netzwerkadapter – WMI und CDM Provider

Überblick
Ändern der Adapter-, Gruppen- oder VLAN-Einstellungen
Erstellen einer neuen (leeren) Gruppe
Hinzufügen eines Adapters zu einer Gruppe
Entfernen eines Adapters aus einer Gruppe
Löschen einer Gruppe
Ändern des Modus einer Gruppe
Ändern der Priorität eines Adapters in einer Gruppe
Deinstallieren eines Adapters
Erstellen eines VLAN
Ändern der Attribute eines VLAN
Löschen eines VLAN
Aktualisieren des Boot Agent


Überblick

In den meisten Fällen muss die Client-Anwendung zur Aktualisierung der Konfiguration ein Sitzungshandle von der IANet_NetService-Klasse erhalten und dieses Handle in einem IWbemContext-Kontextobjekt speichern. Änderungen in der Konfiguration werden nur dann wirksam, wenn die Apply-Methode für IANet_NetService aufgerufen wird. Es gibt einige Ausnahmen für diese Anforderung:

Bei manchen Vorgängen können Sie das PreCheck-Qualifizierungsmerkmal im Kontext verwenden, um festzustellen, ob ein Vorgang erlaubt ist. Auf diese Weise ist es über die Benutzeroberfläche möglich, bestimmte Steuerelemente oder Menüpunkte bei Bedarf zu deaktivieren.

Zurück zum Seitenanfang


Ändern der Adapter-, Gruppen- oder VLAN-Einstellungen

Ändern der Adapter-, Gruppen- oder VLAN-Einstellungen:

Zum Ändern einer Adapter-, VLAN- oder Gruppen-Einstellung muss der Client zuerst den Objektpfad für die Einstellung erhalten, die geändert wird. Die beste Methode besteht darin, die Einstellungen auf dem Objekt aufzulisten und das __PATH-Attribut der Einstellung zu speichern (siehe oben).

Die Aktualisierung einer Einstellung ist am einfachsten auf folgende Weise möglich:

  1. Rufen Sie eine Instanz des Einstellungsobjekts von WMI ab.
  2. Ändern Sie das CurrentValue-Attribut (mithilfe von IWbemClassObject::Put()).
  3. Rufen Sie IWbemServices::PutInstance() auf, um die geänderte Instanz zum WMI Provider zurückzuleiten. PutInstance muss mit dem Kennzeichen WBEM_FLAG_UPDATE_ONLY aufgerufen werden.

Der WMI Provider validiert CurrentValue und gibt WBEM_E_FAIL zurück, falls die Validierung fehlschlägt. Der genaue Grund für das Versagen wird im Beschreibungsattribut des IANet_ExtendedStatus-Objekts angegeben.

Folgende einstellungsspezifischen Beschreibungen sind möglich:

Die letzte Beschreibung wird zurückgegeben, wenn der aktuelle Wert für IANet_SettingEnum, IANet_SettingSlider oder IANet_SettingMultiSelection keinem der zulässigen Werte entspricht.

Das einzige Attribut für eine Einstellung, das der Client ändern kann, ist CurrentValue. Der WMI Provider ignoriert alle Änderungen an anderen Werten.

Für die Einstellungsklasse sind keine unterstützten Methoden vorhanden. Wenn Sie Änderungen an einer Einstellung durchführen möchten, ändern Sie die CurrentValue-Eigenschaft und rufen Sie PutInstance auf.

Zurück zum Seitenanfang


Erstellen einer neuen (leeren) Gruppe

Erstellen einer neuen Gruppe:

Wenn Sie eine neue Gruppe erstellen möchten, erstellen Sie eine Instanz von IANet_TeamOfAdapters (verwenden Sie z. B. IWbemServices::GetObject(), um ein Klassenobjekt für IANet_TeamOfAdapters zu erhalten, und verwenden Sie dann IWbemServices::SpawnInstance(), um eine Instanz dieses Objekts zu erstellen).

Verwenden Sie danach IWbemClassObject::Put, um das TeamMode-Attribut in der Instanz auf den gewünschten Gruppentyp (z. B. AFT) einzustellen. Rufen Sie schließlich IWbemServices::PutInstance() auf, um die Gruppe mit dem Kennzeichen WBEM_FLAG_CREATE_ONLY zu erstellen.

Der Objektpfad für die neue Gruppe wird in IWbemCallResultObject gespeichert. Dieses Objekt wird an Sie zurückgeleitet, wenn der Aufruf abgeschlossen ist. Mit der Methode IWbemCallResult::GetResultString wird der neue Objektpfad ermittelt.

Falls dieser Vorgang fehlschlägt, sollten Sie IANet_ExtendedStatus überprüfen, um die Gründe für das Versagen zu ermitteln.

Die virtuellen IANet_EthernetAdapter- und IANet_IPProtocolEndpoint-Klassen für die Gruppe stehen erst zur Verfügung, wenn Apply aufgerufen wurde. Für den Zugriff auf die Einstellungen für die Gruppe kann das IANet_Configuration-Objekt verwendet werden, das mit der neuen IANet_TeamOfAdapters-Instanz assoziiert ist.

Zurück zum Seitenanfang


Hinzufügen eines Adapters zu einer Gruppe

Hinzufügen eines Adapters zu einer Gruppe:

Wenn Sie einer Gruppe einen Adapter hinzufügen möchten, erstellen Sie eine Instanz von IANet_TeamedMemberAdapter (verwenden Sie z. B. IWbemServices::GetObject(), um ein Klassenobjekt für IANet_TeamedMemberAdapter zu erhalten, und verwenden Sie dann IWbemServices::SpawnInstance(), um eine Instanz dieses Objekts zu erstellen).

Die folgenden Attribute im Objekt müssen mithilfe von IWbemClassObject::Put() eingestellt werden:

Sie können auch die Priorität des Adapters in der Gruppe einstellen. Rufen Sie schließlich IWbemServices::PutInstance() auf, um den Adapter der Gruppe mit dem Kennzeichen WBEM_FLAG_CREATE_ONLY hinzuzufügen. Falls dieser Vorgang fehlschlägt, ermitteln Sie den Fehlercode in IANet_ExtendedStatus.

Zurück zum Seitenanfang


Entfernen eines Adapters aus einer Gruppe

Entfernen eines Adapters aus einer Gruppe:

Wenn Sie einen Adapter aus einer Gruppe entfernen möchten, löschen Sie die IANet_TeamedMemberAdapter-Instanz, die den Adapter mit der Gruppe assoziiert, mithilfe von IWbemServices::DeleteInstance(). Falls dieser Vorgang fehlschlägt, ermitteln Sie den Fehlercode in IANet_ExtendedStatus.

Zurück zum Seitenanfang


Löschen einer Gruppe

Löschen einer Gruppe:

Wenn Sie eine Gruppe löschen möchten, löschen Sie die IANet_TeamOfAdapters-Instanz mithilfe von IWbemServices::DeleteInstance(). Falls dieser Vorgang fehlschlägt, ermitteln Sie den Fehlercode in IANet_ExtendedStatus.

Zurück zum Seitenanfang


Ändern des Modus einer Gruppe

Ändern des Modus einer Gruppe:

Wenn Sie den Modus einer Gruppe ändern möchten, ermitteln Sie die Instanz von IANet_TeamOfAdapters für die Gruppe (verwenden Sie z. B. IWbemServices::GetObject mit dem Objektpfad der Gruppe). Verwenden Sie dann IWbemClassObject::Put, um das TeamMode-Attribut für die Gruppe zu ändern. Rufen Sie schließlich IWbemClassObject:: PutInstance auf, um dem WMI Provider mit dem Kennzeichen WBEM_FLAG_UPDATE_ONLY den Befehl zur Aktualisierung des Gruppenmodus zu geben. Falls dieser Vorgang fehlschlägt, ermitteln Sie den Fehlercode in IANet_ExtendedStatus.

Zurück zum Seitenanfang


Ändern der Priorität eines Adapters in einer Gruppe

Ändern der Priorität eines Adapters in einer Gruppe:

Zum Ändern der Priorität eines Adapters sollte der Client zuerst die IANet_TeamedMemberAdapter-Instanz für den Adapter ermitteln (verwenden Sie z. B. IWbemServices::GetObject mit dem Objektpfad). Der Client kann dann IWbemClassObject::Put verwenden, um das AdapterFunction-Attribut für den Adapter zu ändern. Schließlich muss der Client IWbemClassObject:: PutInstance aufrufen, um dem WMI Provider den Befehl zur Aktualisierung der Priorität des Adapters zu geben. Falls dieser Vorgang fehlschlägt, sollte der Client den Fehlercode in IANet_ExtendedStatus feststellen.

Zurück zum Seitenanfang


Deinstallieren eines Adapters

Deinstallieren eines Adapters:

Wenn Sie einen Adapter deinistallieren möchten, rufen Sie IWbemServices::DeleteInstance auf. Geben Sie dabei den Objektpfad des zu deinstallierenden Adapters an.

Zurück zum Seitenanfang


Erstellen eines VLAN

Erstellen eines VLAN:

Wenn Sie ein VLAN erstellen möchten, rufen Sie die CreateVLAN-Methode auf dem IANet_802dot1QVLANService für den Adapter auf, dem das VLAN hinzugefügt werden soll. Die folgenden Argumente müssen an die Methode weitergeleitet werden:

Durch diese Funktion wird der Objektpfad des neu erstellten VLAN im Out-Parameter VLANpath zurückgegeben. Falls dieser Vorgang fehlschlägt, ermitteln Sie den Fehlercode in IANet_ExtendedStatus.

Zurück zum Seitenanfang


Ändern der Attribute eines VLAN

Ändern der Attribute eines VLAN:

Der Client kann die VLANNumber- und VLANName-Attribute für ein VLAN ändern. Wenn Sie die Priorität eines Adapters ändern möchten, ermitteln Sie zuerst die Instanz von IANet_VLAN für den Adapter (verwenden Sie z. B. IWbemServices::GetObject mit dem Objektpfad der Gruppe).

Geben Sie dann für VLANNumber oder VLANName die gewünschten Werte ein. Rufen Sie schließlich IWbemClassObject:: PutInstance auf, um dem WMI Provider mit dem Kennzeichen WBEM_FLAG_UPDATE_ONLY den Befehl zur Aktualisierung der Attribute zu geben. Falls dieser Vorgang fehlschlägt, ermitteln Sie den Fehlercode in IANet_ExtendedStatus.

Zurück zum Seitenanfang


Löschen eines VLAN

Löschen eines VLAN:

Wenn Sie ein VLAN deinistallieren möchten, rufen Sie IWbemServices::DeleteInstance auf. Geben Sie dabei den Objektpfad des zu löschenden VLAN an.

Zurück zum Seitenanfang


Aktualisieren des Boot Agent

Aktualisieren des Boot Agent:

Der Client kann das Boot Agent-Image mithilfe von Methodenaufrufen aktualisieren. Ermitteln Sie zum Lesen/Schreiben eines Flash-Image zuerst die Instanz von IANet_BootAgent für den Adapter (verwenden Sie z. B. IWbemServices::GetObject mit dem Objektpfad der Gruppe).

Führen Sie dann ReadFlash() aus, um das vorhandene Flash-Boot-ROM-Image zu lesen, oder ProgramFlash(), um das Flash-Boot-ROM-Image zu aktualisieren. Falls dieser Vorgang fehlschlägt, ermitteln Sie den Fehlercode in IANet_ExtendedStatus.

 
Aufgabe WMI-Methoden Ergebnis Kommentare
Aktualisieren oder Einfügen eines Boot-ROM-Image für den Adapter uint32 ProgramFlash(
                           [IN,
          ValueMap {"0","1"} ,
          Values {"Check Version", "Write Flash"}: Amended
                           ]
                           uint32 Action,
                           [IN]
                           uint8 NewFlashData[],
                           [OUT]
                           string strErrorMessage
                           );
Wenn die Aktion "Check Version" (Version überprüfen) angegeben wird, wird bei dieser Methode eine Warnmeldung zurückgegeben, falls das zu aktualisierende Boot-ROM-Image in NewFlashData[] älter als das auf dem NIC vorhandene Image ist.

Wenn die Aktion "Write" (Schreiben) angegeben wird, wird der FLASH-ROM-Speicher auf dem NIC mit NewFlashData[] aktualisiert.

Diese Methode wird zur Aktualisierung des Flash-ROM-Speichers auf dem NIC verwendet. Während der Aktualisierung des Flash-Speichers unterbricht der NIC die Kommunikation mit dem Netzwerk.
Lesen des Boot-ROM-Image uint32 ReadFlash( [OUT] uint8
FlashData[] );
FlashData[] enthält das Flash-ROM-Image auf dem NIC. Diese Methode dient zum Lesen des Flash-ROM-Speichers auf dem NIC. Die Daten können in einer Datei gespeichert werden.


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


Zurück zur Inhaltsseite     Zurück zum Seitenanfang