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

[La classe CWbemProviderGlue fa parte di WMI Provider Framework, considerata allo stato finale e non sarà disponibile ulteriore sviluppo, miglioramenti o aggiornamenti per problemi non correlati alla sicurezza che interessano queste librerie. Le API MI devono essere usate per tutti i nuovi sviluppi.

Il metodo GetAllDerivedInstances recupera un elenco di istanze di una classe base o elementi figlio di tale classe di base.

Sintassi

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

Parametri

pszBaseClassName

Puntatore al nome della classe di base per cui deve essere restituito l'elenco.

pList

Puntatore a un elenco collegato di istanze derivate dalla classe specificata da pszBaseClassName.

pMethodContext

Puntatore al contesto corrente. È necessario fornire un contesto per evitare deadlock. Usare il contesto passato al provider da Provider::EnumerateInstances o Provider::ExecQuery oppure ottenerlo dall'istanza usando CInstance::GetMethodContext. Questo parametro non deve essere NULL.

pszNamespace

Spazio dei nomi della classe specificato da pszBaseClassName. Quando questo parametro è NULL, viene usata la radice dello spazio dei nomi predefinita\cimv2.

Valore restituito

Il metodo restituisce WBEM_S_NO_ERROR se l'operazione ha esito positivo, WBEM_E_OUT_OF_MEMORY se l'operazione non è riuscita a causa della mancanza di memoria o di qualsiasi altro codice di errore HRESULT .

Commenti

Il metodo GetAllDerivedInstances consente ai provider di framework di accedere ai dati da altri provider. I provider di framework passano il nome di una classe di base a GetAllDerivedInstances, che restituisce un elenco di tutte le istanze derivate da esso.

I codici restituiti includono tutte le possibili restituzioni da IWbemServices::ExecQuery.

Questo metodo è semanticamente equivalente alla query SELECT * FROM pszBaseClassName.

Requisiti