Metodo Provider::GetObject(CInstance*,long,CFrameworkQuery&) (provider.h)

[La classe Provider fa parte di WMI Provider Framework, che viene ora considerata in stato finale e non saranno disponibili ulteriori sviluppi, 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 GetObject viene chiamato da WMI per recuperare un'istanza di una classe.

Sintassi

HRESULT GetObject(
        CInstance         *pInstance,
  [ref] long              lFlags,
        CFrameworkQuery & Query
);

Parametri

pInstance

TBD

[ref] lFlags

Oggetto query che indica il set di proprietà da popolare, come richiesto da una chiamata a Provider::GetObject.

Un provider può ottenere un miglioramento significativo delle prestazioni compilando solo questi valori di proprietà richiesti. Il provider determina le proprietà richieste tramite CFrameworkQuery::IsPropertyRequired. In caso contrario, il provider deve compilare tutti i valori delle proprietà.

Query

TBD

Valore restituito

L'implementazione predefinita del provider di framework di questo metodo restituisce WBEM_E_PROVIDER_NOT_CAPABLE al metodo chiamante. Il metodo IWbemServices::GetObject elenca i valori restituiti comuni, anche se è possibile scegliere di implementare qualsiasi valore restituito COM.

Commenti

WMI richiama spesso GetObject in risposta a una chiamata client a IWbemServices::GetObject. La versione WMI di Provider::GetObject fornisce un'istanza con solo le proprietà chiave popolate. Al contrario, un provider di framework implementato deve compilare tutte le altre proprietà. Di seguito viene descritto un override comune di GetObject:

1. Determinare l'istanza WMI richiesta leggendo le proprietà chiave con un metodo Get da CInstance, ad esempio CInstance::GetCHString.
2. Popolare il resto delle proprietà dell'istanza usando i numerosi metodi Set della classe CInstance , ad esempio CInstance::SetByte o CInstance::SetStringArray.

Requisiti