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

O método IWbemConfigureRefresher::AddObjectByPath adiciona um objeto a um atualizador especificando um caminho de objeto.

Sintaxe

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [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. O provedor deverá chamar AddRef nesse ponteiro se ele for chamar novamente para o Gerenciamento do Windows durante sua execução.

[in] wszPath

Cadeia de caracteres Unicode de 16 bits terminada em nulo que contém o caminho do objeto que você adiciona ao atualizador.

[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 contém 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 o 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

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

Nota 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

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 (inclua Wbemidl.h)
Biblioteca Wbemuuid.lib

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