Voltar à página do índice

Atualização da configuração: Guia do usuário de provedores WMI e CDM dos adaptadores de rede Intel® PRO

Visão geral
Alteração das configurações de adaptador, grupo ou VLAN
Criação de um novo grupo (Vazio)
Acréscimo de um adaptador a um grupo
Remoção do adaptador de um grupo
Exclusão de um grupo
Alteração do modo de um grupo
Alteração da prioridade de um adaptador dentro de um grupo
Desinstalação de um adaptador
Criação de uma VLAN
Alteração dos atributos de uma VLAN
Exclusão de uma VLAN
Atualização do boot agent


Visão geral

Na maioria dos casos, para atualizar a configuração, o aplicativo cliente precisa obter um identificador da sessão da classe IANet_NetService e armazenar a identificação em um objeto de contexto IWbemContext. As alterações na configuração só ocorrem quando o método Apply no IANet_NetService é chamado. Existem algumas exceções para esse requisito:

Em algumas operações, você pode usar o qualificador PreCheck no contexto para verificar se a operação é permitida. Isso acontece para permitir que a interface desabilite determinados controles ou itens de menu se for necessário.

Voltar ao início


Alteração das configurações do adaptador, grupo ou VLAN

Alterar o adaptador, grupo ou VLAN

Para alterar a configuração de um adaptador, VLAN ou grupo, o cliente deve obter primeiro o caminho de objeto da configuração que irá alterar. A melhor forma de fazer isso é enumerar as configurações do objeto e armazenar o atributo __PATH da configuração (consulte os parágrafos acima).

A forma mais fácil de o cliente atualizar uma configuração é a seguinte:

  1. Obter a instância do objeto de configuração do WMI.
  2. Modificar o atributo CurrentValue (usando IWbemClassObject::Put()).
  3. Chamar IWbemServices::PutInstance() para passar a instância modificada ao provedor WMI. PutInstance deve ser chamado com o indicador WBEM_FLAG_UPDATE_ONLY.

O provedor WMI valida CurrentValue e retorna WBEM_E_FAIL se a validação falhar. O motivo exato da falha será retornado no atributo Description do objeto IANet_ExtendedStatus.

As descrições específicas da configuração envolvem:

A última descrição é retornada quando o valor atual de IANet_SettingEnum, IANet_SettingSlider ou IANet_SettingMultiSelection não for um dos valores permitidos.

O único atributo de configuração que o cliente pode alterar é CurrentValue. O provedor WMI ignora as alterações feitas a qualquer um dos outros valores.

Não há métodos suportados na classe de configuração. Para fazer alterações em uma configuração, modifique a propriedade CurrentValue, chame PutInstance.

Voltar ao início


Criação de um novo grupo (Vazio)

Criação de um novo grupo

Para criar um novo grupo, crie uma instância de IANet_TeamOfAdapters (ou seja., use IWbemServices::GetObject() para obter um objeto de classe para IANet_TeamOfAdapters e, em seguida, utilize IWbemServices::SpawnInstance() para criar uma instância para esse objeto).

Em seguida, use IWbemClassObject::Put para configurar o atributo TeamMode na instância para que seja do tipo que você deseja para o grupo (exemplo: AFT). Por fim, chame IWbemServices::PutInstance() para criar o grupo, passando o indicador WBEM_FLAG_CREATE_ONLY.

O caminho de objeto do novo grupo é armazenado em IWbemCallResultObject que é passado novamente a você quando a chamada termina. O método IWbemCallResult::GetResultString obtém o novo caminho de objeto.

Se essa ação falhar, o cliente deve verificar o status de IANet_ExtendedStatus para ver os motivos da falha.

As classes IANet_EthernetAdapter virtual e IANet_IPProtocolEndpoint do grupo não ficam disponíveis até que Apply seja chamado. É possível acessar as configurações do grupo por meio do objeto IANet_Configuration associado ao novo IANet_TeamOfAdapters.

Voltar ao início


Acréscimo de um adaptador a um grupo

Acréscimo de um Adaptador a um Grupo:

Para adicionar um adaptador a um grupo, crie uma instância de IANet_TeamedMemberAdapter (ou seja., use IWbemServices::GetObject() para obter um objeto de classe para IANet_TeamedMemberAdapter e, em seguida, utilize IWbemServices::SpawnInstance() para criar uma instância para esse objeto).

É necessário configurar os seguintes atributos do objeto por meio de IWbemClassObject::Put():

Também é possível configurar a prioridade para o adaptador no grupo. Por fim, chame IWbemServices::PutInstance() para adicionar o adaptador ao grupo, passando o indicador WBEM_FLAG_CREATE_ONLY. Se essa ação falhar, verifique IANet_ExtendedStatus para ver o código de erro.

Voltar ao início


Remoção de um adaptador de um grupo

Remoção de um adaptador de um grupo:

Para remover um adaptador de um grupo, exclua a instância IANet_TeamedMemberAdapter que associa o adaptador ao grupo usando IWbemServices::DeleteInstance(). Se essa ação falhar, verifique IANet_ExtendedStatus para ver o código de erro.

Voltar ao início


Exclusão de um grupo

Exclusão de um grupo:

Para excluir um grupo, exclua a instância IANet_TeamOfAdapters usandoIWbemServices::DeleteInstance(). Se essa ação falhar, verifique IANet_ExtendedStatus para ver o código de erro.

Voltar ao início


Alteração do modo de um grupo

Alteração do modo de um grupo:

Para alterar o modo de um grupo, obtenha a instância de IANet_TeamOfAdapters para o grupo (por exemplo: use IWbemServices::GetObject utilizando o caminho de objeto do grupo). Em seguida, use IWbemClassObject::Put para alterar o atributo TeamMode do grupo. Por fim, chame IWbemClassObject:: PutInstance para instruir o provedor WMI a atualizar o modo do grupo, passando o indicador WBEM_FLAG_UPDATE_ONLY. Se essa ação falhar, verifique IANet_ExtendedStatus para ver o código de erro.

Voltar ao início


Alteração da prioridade de um adaptador dentro de um grupo

Alteração da prioridade de um adaptador dentro de um grupo:

Para alterar a prioridade de um adaptador, o cliente deve primeiro obter a instância de IANet_TeamedMemberAdapter para o adaptador. (por exemplo: use IWbemServices::GetObject usando o caminho do objeto). Em seguida, use IWbemClassObject::Put para alterar o atributo AdapterFunction do adaptador. Por fim, o cliente precisa chamar IWbemClassObject:: PutInstance para instruir o provedor WMI a atualizar a prioridade do adaptador. Se essa ação falhar, o cliente deve verificar IANet_ExtendedStatus para ver o código de erro.

Voltar ao início


Desinstalação de um adaptador

Desinstalação de um adaptador:

Para desinstalar um adaptador, chame IWbemServices::DeleteInstance, passando o caminho de objeto do adaptador a ser desinstalado.

Voltar ao início


Criação de uma VLAN

Criação de uma VLAN:

Para criar uma VLAN, chame o método CreateVLAN no IANet_802dot1QVLANService referente ao adaptador ao qual a VLAN deve ser adicionada. É necessário passar os seguintes argumentos ao método:

A função retorna o caminho de objeto da VLAN recém-criada no parâmetro de saída (Out) VLANpath. Se essa ação falhar, verifique IANet_ExtendedStatus para ver o código de erro.

Voltar ao início


Alteração dos atributos de uma VLAN

Alteração dos atributos de uma VLAN:

O cliente pode alterar os atributos VLANNumber e VLANName de uma VLAN. Para alterar a prioridade de um adaptador, primeiro obtenha a instância de IANet_VLAN referente ao adaptador (por exemplo: use IWbemServices::GetObject utilizando o caminho de objeto).

Em seguida, altere VLANNumber ou VLANName de acordo com os valores desejados. Por fim, chame IWbemClassObject:: PutInstance para instruir o provedor WMI a atualizar os atributos, passando o indicador WBEM_FLAG_UPDATE_ONLY. Se essa ação falhar, verifique IANet_ExtendedStatus para ver o código de erro.

Voltar ao início


Exclusão de uma VLAN

Exclusão de uma VLAN:

Para excluir uma VLAN, chame IWbemServices::DeleteInstance, passando o caminho de objeto da VLAN a ser excluída.

Voltar ao início


Atualização do boot agent

Atualização do boot agent

O cliente pode atualizar a Boot Agent Image usando chamadas de métodos. Para ler/gravar uma imagem flash, primeiro obtenha a instância de IANet_BootAgent referente ao adaptador (por exemplo: use IWbemServices::GetObject utilizando o caminho de objeto).

Em seguida, execute ReadFlash() para ler a imagem da ROM de inicialização flash ou ProgramFlash() para atualizar essa imagem. Se essa ação falhar, verifique IANet_ExtendedStatus para ver o código de erro.

 
Tarefa Métodos WMI Resultado Comentários
Atualize ou insira uma imagem da ROM de inicialização para o adaptador. uint32 ProgramFlash(
                              [IN,
          ValueMap {"0","1"} ,
          Values {"Check Version", "Write Flash"}: Amended
                             ]
                             uint32 Action,
                             [IN]
                             uint8 NewFlashData[],
                             [OUT]
                             string strErrorMessage
                             );
Se a ação “Check Version” for especificada, esse método retornará uma mensagem de advertência, caso a imagem da ROM de inicialização que está sendo atualizada como em NewFlashData[] for mais antiga que a já existente no NIC.

Se a ação “Write” for especificada, esse comando atualiza a ROM FLASH no NIC com NewFlashData[].

Esse método é usado para atualizar a ROM FLASH no NIC. Isso fará com que o NIC pare de se comunicar com a rede enquanto o flash é atualizado.
Ler a imagem da ROM de inicialização uint32 ReadFlash( [OUT] uint8
FlashData[] );
FlashData[] contém a imagem de ROM Flash no NIC. Esse método lê a ROM Flash no NIC que pode ser salva em arquivo.


Leia todas as restrições e isenções de responsabilidade.


Voltar à página do Índice   Voltar ao início