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
| Requisito | Valor |
|---|---|
| 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 |