Retour à la table des matières

Mise à jour de la configuration : Guide de l'utilisateur des fournisseurs WMI et CDM pour cartes réseau Intel® PRO

Présentation
Modification des paramètres d'une carte, d'une association ou d'un réseau local virtuel
Création d'une association (vide)
Ajout d'une carte à une association
Suppression d'une carte d'une association
Suppression d'une association
Modification du mode d'une association
Modification de la priorité d'une carte au sein d'une association
Désinstallation d'une carte
Création d'un réseau local virtuel (VLAN)
Modification des attributs d'un réseau local virtuel
Suppression d'un réseau local virtuel
Mise à jour de Boot Agent


Présentation

Dans la plupart des cas, l'application cliente doit obtenir un descripteur de session de la classe IANet_NetService, et le stocker dans un objet de contexte IWbemContext pour mettre à jour la configuration. Les modifications de la configuration ne sont prises en compte que lorsque la méthode Apply est appelée sur IANet_NetService. Cette condition comporte quelques exceptions :

Pour certaines opérations, vous pouvez utiliser le qualificateur PreCheck (Pré-contrôle) dans le contexte pour vérifier si une opération est autorisée. Cela permet à l'interface utilisateur de désactiver certaines commandes ou certains éléments de menu, le cas échéant.

Retour au début de la page


Modification des paramètres d'une carte, d'une association ou d'un réseau local virtuel

La modification d'une carte, d'une association ou d'un réseau local virtuel :

Pour modifier un paramètre de carte, d'association ou de réseau local virtuel, le client doit tout d'abord obtenir le chemin d'accès à l'objet du paramètre à modifier. Pour ce faire, la meilleure solution est d'énumérer les paramètres pour l'objet et de stocker l'attribut __PATH du paramètre (voir ci-dessus).

Le moyen le plus facile pour le client de mettre un paramètre à jour est :

  1. d'obtenir une instance de l'objet Setting de WMI ;
  2. de modifier l'attribut CurrentValue (en utilisant IWbemClassObject::Put()) ;
  3. d'appeler IWbemServices::PutInstance() pour renvoyer l'instance modifiée au fournisseur WMI. PutInstance doit être appelé avec l'indicateur WBEM_FLAG_UPDATE_ONLY.

Le fournisseur WMI va valider la valeur actuelle CurrentValue et renvoyer WBEM_E_FAIL si la validation échoue. La raison exacte de l'échec sera renvoyée dans l'attribut Description de l'objet IANet_ExtendedStatus.

Les descriptions spécifiques aux paramètres incluent :

La dernière description est renvoyée lorsque la valeur actuelle pour IANet_SettingEnum, IANet_SettingSlider ou IANet_SettingMultiSelection n'est pas une valeur autorisée.

Le seul attribut que le client puisse modifier pour un paramètre est CurrentValue. Le fournisseur WMI ignore toute modification apportée aux autres valeurs.

Il n'y a aucune méthode prise en charge pour la classe Setting. Pour modifier un paramètre, modifiez la propriété CurrentValue et appelez PutInstance.

Retour au début de la page


Création d'une association (vide)

La création d'une association :

Pour créer une association, créez une instance de IANet_TeamOfAdapters (c.-à-d., utilisez IWbemServices::GetObject() pour obtenir un objet de classe pour IANet_TeamOfAdapters, et utilisez ensuite IWbemServices::SpawnInstance() pour créer une instance de cet objet).

Utilisez ensuite IWbemClassObject::Put pour définir l'attribut TeamMode dans l'instance et lui attribuer le type d'association désiré (p. ex. AFT). Enfin, appelez IWbemServices::PutInstance() pour créer l'association en passant l'indicateur WBEM_FLAG_CREATE_ONLY.

Le chemin d'accès à l'objet pour la nouvelle association est stocké dans l'objet IWbemCallResultObject qui est renvoyé lorsque l'appel est terminé. La méthode IWbemCallResult::GetResultString obtiendra le nouveau chemin d'accès à l'objet.

Si cette action échoue, le client doit vérifier l'état IANet_ExtendedStatus pour obtenir les raisons de l'échec.

Les classes virtuelles IANet_EthernetAdapter et IANet_IPProtocolEndpoint de l'association ne sont disponibles qu'après l'appel de la méthode Apply. Les paramètres de l'association sont accessibles en utilisant l'objet IANet_Configuration associé avec le nouveau IANet_TeamOfAdapters.

Retour au début de la page


Ajout d'une carte à une association

L'ajout d'une carte à une association :

Pour ajouter une carte à une association, créez une instance de IANet_TeamedMemberAdapter (c.-à-d., utilisez IWbemServices::GetObject() pour obtenir un objet de classe pour IANet_TeamedMemberAdapter, et utilisez ensuite IWbemServices::SpawnInstance() pour créer une instance de cet objet).

Les attributs suivants de l'objet doivent être définis en utilisant IWbemClassObject::Put() :

Vous pouvez également définir la priorité de la carte au sein de l'association. Enfin, appelez IWbemServices::PutInstance() pour ajouter la carte à l'association en passant l'indicateur WBEM_FLAG_CREATE_ONLY. Si cette action échoue, vérifiez IANet_ExtendedStatus pour obtenir le code d'erreur.

Retour au début de la page


Suppression d'une carte d'une association

La suppression d'une carte d'une association :

Pour supprimer une carte d'une association, supprimez l'instance IANet_TeamedMemberAdapter qui associe la carte à l'association en utilisant IWbemServices::DeleteInstance(). Si cette action échoue, vérifiez IANet_ExtendedStatus pour obtenir le code d'erreur.

Retour au début de la page


Suppression d'une association

La suppression d'une association :

Pour supprimer une association, supprimez l'instance IANet_TeamOfAdapters en utilisant IWbemServices::DeleteInstance(). Si cette action échoue, vérifiez IANet_ExtendedStatus pour obtenir le code d'erreur.

Retour au début de la page


Modification du mode d'une association

La modification du mode d'une association :

Pour modifier le mode d'une association, obtenez l'instance de IANet_TeamOfAdapters pour l'association (p. ex., utilisez IWbemServices::GetObject avec le chemin d'accès à l'objet de l'association). Utilisez ensuite IWbemClassObject::Put pour modifier l'attribut TeamMode pour l'association. Enfin, appelez IWbemClassObject:: PutInstance pour demander au fournisseur WMI de mettre à jour le mode de l'association en passant l'indicateur WBEM_FLAG_UPDATE_ONLY. Si cette action échoue, vérifiez IANet_ExtendedStatus pour obtenir le code d'erreur.

Retour au début de la page


Modification de la priorité d'une carte au sein d'une association

La modification de la priorité d'une carte au sein d'une association :

Pour modifier la priorité d'une carte au sein d'une association, le client doit d'abord obtenir l'instance de IANet_TeamedMemberAdapter pour la carte (p. ex., utilisez IWbemServices::GetObject avec le chemin d'accès à l'objet). Le client peut ensuite utiliser IWbemClassObject::Put pour modifier l'attribut AdapterFunction pour la carte. Enfin, le client doit appeler IWbemClassObject:: PutInstance pour demander au fournisseur WMI de mettre à jour la priorité de la carte. Si cette action échoue, le client doit vérifier IANet_ExtendedStatus pour obtenir le code d'erreur.

Retour au début de la page


Désinstallation d'une carte

La désinstallation d'une carte :

Pour désinstaller une carte, appelez IWbemServices::DeleteInstance en passant le chemin d'accès à l'objet de la carte à désinstaller.

Retour au début de la page


Création d'un réseau local virtuel (VLAN)

La création d'un réseau local virtuel :

Pour créer un réseau local virtuel, appelez la méthode CreateVLAN sur le service IANet_802dot1QVLANService pour la carte sur laquelle le réseau local virtuel doit être ajouté. Les arguments suivants doivent être passés à la méthode :

La fonction renvoie le chemin d'accès à l'objet du nouveau réseau local virtuel dans le paramètre de sortie VLANpath. Si cette action échoue, vérifiez IANet_ExtendedStatus pour obtenir le code d'erreur.

Retour au début de la page


Modification des attributs d'un réseau local virtuel

La modification des attributs d'un réseau local virtuel :

Le client peut modifier les attributs VLANNumber et VLANName d'un réseau local virtuel. Pour modifier la priorité d'une carte, obtenez tout d'abord l'instance de IANet_VLAN pour la carte (p. ex., utilisez IWbemServices::GetObject avec le chemin d'accès à l'objet).

Modifiez ensuite VLANNumber ou VLANName en leur attribuant la valeur désirée. Enfin, appelez IWbemClassObject:: PutInstance pour demander au fournisseur WMI de mettre à jour les attributs en passant l'indicateur WBEM_FLAG_UPDATE_ONLY. Si cette action échoue, vérifiez IANet_ExtendedStatus pour obtenir le code d'erreur.

Retour au début de la page


Suppression d'un réseau local virtuel

La suppression d'un réseau local virtuel :

Pour supprimer un réseau local virtuel, appelez IWbemServices::DeleteInstance en passant le chemin d'accès à l'objet du réseau local virtuel à supprimer.

Retour au début de la page


Mise à jour de Boot Agent

La mise à jour de Boot Agent :

Le client peut mettre à jour l'image de Boot Agent en utilisant des appels de méthode. Pour lire/écrire dans l'image de la mémoire flash, obtenez tout d'abord l'instance de IANet_BootAgent pour la carte (p. ex., utilisez IWbemServices::GetObject avec le chemin d'accès à l'objet).

Exécutez ensuite ReadFlash() pour lire l'image de la ROM flash de démarrage existante, ou ProgramFlash() pour mettre à jour l'image de la ROM flash de démarrage. Si cette action échoue, vérifiez IANet_ExtendedStatus pour obtenir le code d'erreur.

 
Tâche Méthodes WMI Résultat Commentaire
Mettre à jour ou insérer une image de ROM de démarrage pour la carte uint32 ProgramFlash(
                              [IN,
          ValueMap {"0","1"} ,
          Values {"Check Version", "Write Flash"}: Amended
                             ]
                             uint32 Action,
                             [IN]
                             uint8 NewFlashData[],
                             [OUT]
                             string strErrorMessage
                             );
Si l'action "Check Version" (Vérifier la version) est spécifiée, cette méthode renvoie un message d'avertissement si l'image de la ROM de démarrage mise à jour comme dans NewFlashData[] est plus ancienne que l'image existante sur la carte d'interface réseau.

Si l'action "Write" (Écrire) est spécifiée, la ROM flash de la carte d'interface réseau est mise à jour avec NewFlashData[].

Cette méthode est utilisée pour mettre à jour la ROM flash de la carte d'interface réseau. La liaison entre la carte d'interface réseau et le réseau est interrompue pendant la mise à jour de la mémoire flash.
Lire l'image de la ROM de démarrage uint32 ReadFlash( [OUT] uint8
FlashData[] );
FlashData[] contient la ROM flash de la carte d'interface réseau. Cette méthode lit la ROM flash de la carte d'interface réseau qui peut être enregistrée dans un fichier.


Veuillez lire toutes les restrictions et clauses exonératoires de responsabilité.


Retour à la table des matières    Retour au début de la page