CWbemProviderGlue::GetInstancesByQuery(LPCWSTR,TRefPointerCollection<CInstance>*,MethodContext*,LPCWSTR) (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 GetInstancesByQuery recupera uma lista de instâncias que correspondem a uma consulta específica.

Sintaxe

HRESULT GetInstancesByQuery(
  LPCWSTR                          query,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

Parâmetros

query

Consulta a ser executada.

pList

Lista vinculada de instâncias que correspondem à consulta especificada por Consulta.

pMethodContext

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.

pszNamespace

Ponteiro para o namespace que contém as instâncias. Se NULL, o namespace padrão, raiz\cimv2, será usado.

Retornar valor

O método retornará WBEM_S_NO_ERROR se a operação tiver sido bem-sucedida, WBEM_E_FAILED se a operação falhou ou qualquer outro código de erro HRESULT .

Comentários

O método GetInstancesByQuery permite que os provedores de estrutura acessem dados de outros provedores sem precisar fazer uma chamada à API WMI. Os provedores de estrutura passam uma consulta para GetInstancesByQuery, que retorna as instâncias apropriadas.

Por motivos de desempenho, ao chamar essa função, especifique apenas as propriedades necessárias (por exemplo, especifique " NOME SELECT" em vez de "SELECT *").

Requisitos