Compartilhar via

CWbemProviderGlue::GetAllDerivedInstances(LPCWSTR,TRefPointerCollection<CInstance>*,MethodContext*,LPCWSTR) (wbemglue.h)

  • Artigo

[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 GetAllDerivedInstances recupera uma lista de instâncias de uma classe base ou qualquer filho dessa classe base.

Sintaxe

HRESULT GetAllDerivedInstances(
  LPCWSTR                          pszBaseClassName,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

Parâmetros

pszBaseClassName

Ponteiro para o nome da classe base para a qual a lista deve ser retornada.

pList

Ponteiro para a lista vinculada de instâncias derivadas da classe especificada por pszBaseClassName.

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

Namespace do nome da classe especificado por pszBaseClassName. Quando esse parâmetro é NULL, o namespace padrão root\cimv2 é usado.

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 GetAllDerivedInstances permite que os provedores de estrutura acessem dados de outros provedores. Os provedores de estrutura passam o nome de uma classe base para GetAllDerivedInstances, que retorna uma lista de todas as instâncias derivadas dela.

Os códigos de retorno incluem todos os retornos possíveis de IWbemServices::ExecQuery.

Esse método é semanticamente equivalente à consulta SELECT * FROM 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