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

Com o método IWbemConfigureRefresher::AddObjectByTemplate , você pode adicionar um objeto que deseja atualizar a um atualizador especificando um modelo de instância IWbemClassObject . Use esse método quando for difícil construir um caminho de objeto para um objeto a ser adicionado a um atualizador.

Sintaxe

HRESULT AddObjectByTemplate(
        IWbemServices    *pNamespace,
  [in]  IWbemClassObject *pTemplate,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Parâmetros

pNamespace

Um ponteiro IWbemServices de volta para o Gerenciamento do Windows, que pode atender a qualquer solicitação feita pelo provedor. O provedor deverá chamar AddRef nesse ponteiro se ele for chamar novamente para o Gerenciamento do Windows durante sua execução.

[in] pTemplate

Ponteiro para um objeto IWbemClassObject que contém o modelo de instância.

[in] lFlags

Máscara de bits de sinalizadores que modificam o comportamento desse método. Se esse parâmetro for definido como WBEM_FLAG_USE_AMENDED_QUALIFIERS, a instância retornada conterá qualificadores localizados, se disponível.

[in] pContext

Normalmente NULL; caso contrário, 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 específica do provedor. Para obter mais informações sobre esse parâmetro, consulte Fazendo chamadas para WMI.

[out] ppRefreshable

Ponteiro para manter a referência a um objeto IWbemClassObject , que conterá o objeto de instância atualizável. O cliente deve chamar Release no objeto retornado quando ele não for mais necessário.

[out] plId

Ponteiro para um inteiro retornado pelo provedor que identifica exclusivamente esse objeto 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 HRESULT.

Comentários

A instância fornecida deve especificar um objeto válido, que é fornecido pelo provedor de High-Performance. O objeto retornado não deve ser modificado pelo cliente enquanto uma operação de atualização estiver em processo. O identificador retornado pode ser usado pela função Remover para remover o objeto.

Não é necessário que o usuário remova explicitamente objetos adicionados. O cliente deve chamar Release no objeto retornado quando ele não for mais necessário.

Requisitos

Confira também

Acessar dados de desempenho do C++

IWbemConfigureRefresher

Transformar um provedor de instância em um provedor de alto desempenho

Provedor de Contadores de Desempenho