Voltar à página do índice

Espaço de nomes e contexto: Guia do usuário de provedores WMI e CDM dos adaptadores de rede Intel® PRO


As classes CIM residem em um espaço de nomes. O espaço de nomes padrão da Microsoft* é chamado root/cimv2 e está baseado no CIM v2.2 ou root/default. As classes de provedores WMI e CDM podem ser adicionadas a esse espaço de nomes. Os provedores são baseados no CIM v2.5. Devido a isso e às diferenças utilizadas nas chaves dos objetos, as classes dos provedores estão localizadas em um espaço de nomes separado, root/IntelNCS.

Contexto WBEM

Objetos de contexto fornecem informações adicionais para os provedores que não podem ser passados como um parâmetro para um método de API WMI. Para registrar qualificadores de contexto, utilize o IWbemContext para registrar os qualificadores de contexto. O ponteiro da interface para o objeto de contexto é passado como o último parâmetro de um método IWbemServices.

A tabela a seguir contém os qualificadores de contexto (valores com nomes) utilizado pelos provedores. A maioria dos qualificadores, como o SessionHandle, é utilizada apenas em conjunto com áreas funcionais específicas dos provedores, ao passo que LocaleID, MachineName e ApplicationName podem ser definidos para todas as chamadas de IWbemServices.

Se nenhum contexto for passado para os provedores, eles utilizarão o LocaleID passado na chamada de Initialize para os provedores. Qualquer leitura feita com um contexto lerá a configuração atual até ser realizada uma operação de gravação. Leituras subseqüentes mostrarão o sistema com ele seria após a gravação ocorrer com sucesso. Um contexto nulo pode ser utilizado para leituras.

 
Qualificador de contexto Tipo de variável Descrição
SessionHandle VT_BSTR Identifica a cópia das classes de rede IANet do aplicativo. O aplicativo não pode fazer quaisquer alterações às classes ou a seus atributos sem primeiro estabelecer um identificador de sessão. Consulte a seção na classe IANet_NetService para ver como estabelecer e utilizar um identificador de sessão. Este qualificador não é necessário se o aplicativo irá apenas ler os dados das classes. O identificador da sessão permite ao software NCS gerenciar simultaneamente vários acessos para a configuração sem um usuário bloquear todos os outros. Cada sessão possui um cache separado para armazenar quaisquer mudanças que tenham sido feitas. Se houver vários usuários realizando mudanças simultaneamente, então, o primeiro usuário a aplicar suas mudanças terá sucesso. Todos os outros caches de usuários serão invalidados.
LocaleID VT_BSTR ID da Microsoft para uma localidade. Isso é necessário se o aplicativo necessitar seqüências de texto localizado a partir dos provedores. Todas as mensagens e avisos de erro serão em inglês, a menos que o LocaleID solicitado seja utilizado.
ApplicationName VT_BSTR O nome do aplicativo que efetuou a chamada. Esse procedimento é obrigatório para registros.
MachineName VT_BSTR O nome da máquina que está se conectando aos provedores. Esse procedimento é obrigatório para registros.
PreCheck VT_BOOL Esse valor booleano é utilizado para informar aos provedores que o cliente está tentando verificar se uma operação é permitida antes de efetuar realmente a operação. Por exemplo, adicionar um adaptador a um grupo.

Valores:

  • TRUE = O provedor não executará a operação, mas retornará um código de erro e um status estendido se a operação não for permitida.
  • FALSE = O provedor executará a operação.

Caso esse qualificador esteja faltando, ele terá o mesmo efeito como se o atributo fosse FALSE.

WarningErrorCode VT_I4 Algumas operações podem necessitar que sejam enviados avisos para o usuário (por exemplo, adicionar um adaptador ao grupo pode exigir que o grupo seja recarregado em algumas circunstâncias). O WMI não fornece um mecanismo para isso. Se esse qualificador estiver presente e for diferente de zero, o provedor retornará E_FAIL se a operação for bem sucedida, mas houve um aviso associado. O cliente deverá utilizar o status estendido para obter o texto do aviso.


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


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