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

Vedi anche

CWbemProviderGlue

GetInstanceByPath

GetInstancePropertiesByPath