Método CWbemProviderGlue::GetInstancePropertiesByPath (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 GetInstancePropertiesByPath recupera a instância identificada por um caminho de objeto específico, com apenas as propriedades especificadas preenchidas. As propriedades a serem preenchidas são nomeadas em uma matriz CHString .

Sintaxe

HRESULT GetInstancePropertiesByPath(
        LPCWSTR         pszInstancePath,
        CInstance       **ppInstance,
        MethodContext   *pMethodContext,
  [ref] CHStringArray & csaProperties
);

Parâmetros

pszInstancePath

O caminho do objeto para a instância a ser retornada. Esse parâmetro deve apontar para um caminho completo.

ppInstance

Um ponteiro para um ponteiro para uma nova instância do CInstance cujas chaves são aquelas especificadas por 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, em seguida, obtenha-o da instância usando CInstance::GetMethodContext. Esse parâmetro não deve ser NULL.

[ref] csaProperties

Uma matriz que contém os nomes das propriedades a serem copiadas para a nova instância.

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 especificadas do objeto especificado. Essa é a maneira mais eficiente de recuperar uma instância específica quando mais propriedades do que apenas as chaves são necessárias. Lembre-se de que nem todos os provedores dão suporte a operações de instância parcial. Nesse caso, toda a instância (incluindo as chaves) é 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

GetInstanceKeysByPath