Método IWbemConfigureRefresher::AddEnum (wbemcli.h)

  • Artigo

O método IWbemConfigureRefresher::AddEnum adiciona um enumerador ao atualizador solicitado.

Sintaxe

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [out] long            *plId
);

Parâmetros

[in] pNamespace

Um ponteiro IWbemServices de volta para o Gerenciamento do Windows, que pode atender a qualquer solicitação feita pelo provedor. Se o método precisar chamar de volta para o Gerenciamento do Windows durante sua execução, o provedor deverá chamar AddRef com o ponteiro pNamespace .

[in] wszClassName

Constante, cadeia de caracteres terminada em nulo de caracteres Unicode de 16 bits que contém o nome da classe que é enumerada.

[in] lFlags

Bitmask de sinalizadores que modificam o comportamento desse método. Se esse parâmetro for definido como WBEM_FLAG_USE_AMENDED_QUALIFIERS, as instâncias retornadas conterão qualificadores localizados se estiverem disponíveis.

[in] pContext

Normalmente NULL; caso contrário, esse é um ponteiro para um objeto IWbemContext que é exigido por um ou mais provedores de classe dinâmica. Os valores no objeto de contexto devem ser especificados na documentação do provedor específico. Para obter mais informações sobre esse parâmetro, consulte Fazendo chamadas para WMI.

[out] ppEnum

Ponteiro que contém a referência a um objeto IWbemHiPerfEnum , que conterá a enumeração . O cliente deve chamar Release nesse ponteiro quando ele não for mais necessário.

[out] plId

Ponteiro para um inteiro retornado pelo provedor que identifica exclusivamente a enumeração atualizável.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um

ObservaçãoHRESULT

 
.

Comentários

A classe fornecida deve especificar uma classe válida, que é fornecida pelo provedor de High-Performance. Todas as instâncias do enumerador retornado podem ser consultadas após chamadas. Em cada chamada para atualizar, o número de instâncias no enumerador pode variar. Somente instâncias do nome de classe especificado são retornadas; As subclasses da classe especificada não serão enumeradas porque não há suporte para enumeração detalhada. O enumerador retornado não deve ser tocado pelo cliente enquanto uma operação De atualização estiver em processo. O identificador retornado pode ser usado pela função Remove para remover o objeto . Observe que não é necessário que o usuário remova explicitamente os enumeradores adicionados. No entanto, o cliente deve chamar Release no enumerador retornado quando ele não for mais necessário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemcli.h (include Wbemidl.h)
Biblioteca Wbemuuid.lib

Confira também

IWbemConfigureRefresher