Metodo CWbemProviderGlue::GetInstanceByPath(LPCWSTR,CInstance**,MethodContext*) (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 GetInstanceByPath recupera l'istanza identificata da un determinato percorso oggetto chiamando il metodo GetObject del provider.

Sintassi

HRESULT GetInstanceByPath(
  LPCWSTR       pszObjectPath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Parametri

pszObjectPath

Percorso dell'oggetto dell'istanza da restituire.

ppInstance

Puntatore a un puntatore a un'istanza CInstance usata per archiviare la nuova istanza. Il provider di framework che esegue la richiesta deve rilasciare questo puntatore.

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

Restituisce WBEM_S_NO_ERROR se l'operazione ha avuto 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 GetInstanceByPath consente ai provider di framework di accedere ai dati da un altro provider senza richiedere una chiamata API WMI. I provider di framework passano il percorso dell'oggetto di un'istanza a GetInstanceByPath, che restituisce l'istanza.

Nella versione corrente del framework del provider, pszInstancePath deve essere un percorso dell'istanza nello stesso computer.

Sebbene pMethodContext abbia un valore predefinito null, è 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.

Requisiti

Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemglue.h (include FwCommon.h)
Libreria	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll