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 |