Metodo CWbemProviderGlue::GetAllInstances (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 GetAllInstances recupera un elenco di istanze restituite da una classe specifica.

Sintassi

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

Parametri

pszClassName

Nome della classe per cui deve essere restituito un elenco di istanze.

pList

Elenco collegato di istanze supportate dal provider specificato da pszClassName.

pszNamespace

Spazio dei nomi del provider specificato da pszClassName. Questo parametro può essere NULL per indicare lo spazio dei nomi predefinito, ovvero "Root\CIMv2".

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.

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 GetAllInstances consente ai provider di framework di accedere ai dati da un altro provider senza dover effettuare una chiamata API WMI. I provider di framework passano il nome del provider a GetAllInstances, che restituisce un elenco di tutte le istanze supportate dal provider.

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

Requisiti