Método CWbemProviderGlue::GetInstanceKeysByPath (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 GetInstanceKeysByPath recupera a instância identificada por um caminho de objeto específico, com apenas as propriedades de chave preenchidas.

Sintaxe

HRESULT GetInstanceKeysByPath(
  LPCWSTR       pszInstancePath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Parâmetros

pszInstancePath

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

ppInstance

Um ponteiro para um ponteiro para uma nova instância de CInstance cujas chaves são aquelas especificadas no pszInstancePath. 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.

Retornar valor

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

Esse método usa operações de atualização de instância parcial para solicitar apenas as propriedades de chave do objeto especificado. É a maneira mais eficiente de verificar a existência de um objeto específico. Lembre-se de que nem todos os provedores dão suporte a operações de instância parcial. Nesse caso, toda a instância será preenchida. Para obter mais informações, consulte Suporte a operações de Partial-Instance.

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

Requisitos

Confira também

CWbemProviderGlue

GetInstanceByPath

GetInstancePropertiesByPath