Metodo CWbemProviderGlue::GetInstancesByQuery(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 GetInstancesByQuery recupera un elenco di istanze che corrispondono a una determinata query.

Sintassi

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

Parametri

query

Query da eseguire.

pList

Elenco collegato di istanze che corrispondono alla query specificata da Query.

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

Puntatore allo spazio dei nomi contenente le istanze. Se NULL, viene usato lo spazio dei nomi predefinito cimv2 radice\.

Valore restituito

Il metodo restituisce WBEM_S_NO_ERROR se l'operazione ha esito positivo, WBEM_E_FAILED se l'operazione non è riuscita o qualsiasi altro codice di errore HRESULT .

Commenti

Il metodo GetInstancesByQuery consente ai provider di framework di accedere ai dati da altri provider senza dover effettuare una chiamata API WMI. I provider di framework passano una query a GetInstancesByQuery, che restituisce le istanze appropriate.

Per motivi di prestazioni, quando si chiama questa funzione, specificare solo le proprietà necessarie (ad esempio, specificare "NOME SELECT" anziché "SELECT *").

Requisiti