Compartilhar via


Método CWbemProviderGlue::GetInstanceByPath(LPCWSTR,CInstance**,MethodContext*) (wbemglue.h)

[A classe CWbemProviderGlue faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas para todos os novos desenvolvimentos.]

O método GetInstanceByPath recupera a instância identificada por um caminho de objeto específico chamando o método GetObject do provedor.

Sintaxe

HRESULT GetInstanceByPath(
  LPCWSTR       pszObjectPath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Parâmetros

pszObjectPath

Um caminho de objeto para a instância a ser retornada.

ppInstance

Um ponteiro para um ponteiro para uma instância CInstance usada para armazenar a nova instância. O provedor de estrutura que executa a solicitação deve liberar esse ponteiro.

pMethodContext

Um ponteiro para o contexto atual. Um contexto deve ser fornecido para evitar deadlocks. Use o contexto passado para o provedor por Provider::EnumerateInstances ou Provider::ExecQuery ou obtenha-o da instância usando CInstance::GetMethodContext. Esse parâmetro não deve ser NULL.

Valor retornado

Retorna WBEM_S_NO_ERROR se a operação foi bem-sucedida, WBEM_E_OUT_OF_MEMORY se a operação falhou devido à falta de memória ou a qualquer outro código de erro HRESULT .

Comentários

O método GetInstanceByPath permite que os provedores de estrutura acessem dados de outro provedor sem exigir uma chamada à API WMI. Os provedores de estrutura passam o caminho do objeto de uma instância para GetInstanceByPath, que retorna a instância .

Na versão atual da estrutura do provedor, pszInstancePath deve resolve ser um caminho de instância no mesmo computador.

Embora pMethodContext tenha um valor padrão de NULL, um contexto deve ser fornecido para evitar deadlocks. Use o contexto passado para o provedor por Provider::EnumerateInstances ou Provider::ExecQuery ou obtenha-o da instância usando CInstance::GetMethodContext.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemglue.h (inclua FwCommon.h)
Biblioteca FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll