Metodo CWbemProviderGlue::GetInstanceKeysByPath (wbemglue.h)

[La classe CWbemProviderGlue fa parte di WMI Provider Framework, che è 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 GetInstanceKeysByPath recupera l'istanza identificata da un percorso oggetto specifico, con solo le proprietà chiave popolate.

Sintassi

HRESULT GetInstanceKeysByPath(
  LPCWSTR       pszInstancePath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Parametri

pszInstancePath

Percorso dell'oggetto dell'istanza da restituire.

ppInstance

Puntatore a un puntatore a una nuova istanza CInstance le cui chiavi sono quelle specificate in pszInstancePath. Il provider di framework 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

Questo metodo usa operazioni di aggiornamento parziale dell'istanza per richiedere solo le proprietà chiave dell'oggetto specificato. È il modo più efficiente per verificare l'esistenza di un oggetto specifico. Tenere presente che non tutti i provider supportano operazioni di istanza parziale. In tal caso, l'intera istanza verrà popolata. Per altre informazioni, vedere Supporto delle operazioni di Partial-Instance.

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

Requisiti

Requisito	Valore
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

Vedi anche

CWbemProviderGlue

GetInstanceByPath

GetInstancePropertiesByPath