Método CWbemProviderGlue::GetAllInstances (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 GetAllInstances recupera uma lista de instâncias retornadas por uma classe específica.

Sintaxe

HRESULT GetAllInstances(
  LPCWSTR                          pszClassName,
  TRefPointerCollection<CInstance> *pList,
  LPCWSTR                          pszNamespace,
  MethodContext                    *pMethodContext
);

Parâmetros

pszClassName

Nome da classe para a qual uma lista de instâncias deve ser retornada.

pList

Lista vinculada de instâncias com suporte pelo provedor especificado por pszClassName.

pszNamespace

Namespace do provedor especificado por pszClassName. Esse parâmetro pode ser NULL para indicar o namespace padrão, que é "Root\CIMv2".

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 obtenha-o da instância usando CInstance::GetMethodContext. Esse parâmetro não deve ser NULL.

Retornar valor

O método retornará WBEM_S_NO_ERROR se a operação tiver sido 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 GetAllInstances permite que os provedores de estrutura acessem dados de outro provedor sem precisar fazer uma chamada à API WMI. Os provedores de estrutura passam o nome do provedor para GetAllInstances, que retorna uma lista de todas as instâncias compatíveis com o provedor.

Esse método é semanticamente equivalente à consulta SELECT * FROM pszBaseClassName WHERE __Class = pszBaseClassName.

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