Metodo CWbemProviderGlue::GetInstancePropertiesByPath (wbemglue.h)

Articolo
03/03/2024

[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 GetInstancePropertiesByPath recupera l'istanza identificata da un percorso oggetto specifico, con solo le proprietà specificate popolate. Le proprietà da popolare vengono denominate in una matrice CHString .

Sintassi

HRESULT GetInstancePropertiesByPath(
        LPCWSTR         pszInstancePath,
        CInstance       **ppInstance,
        MethodContext   *pMethodContext,
  [ref] CHStringArray & csaProperties
);

Parametri

pszInstancePath

Percorso dell'oggetto dell'istanza da restituire. Questo parametro deve puntare a un percorso completo.

ppInstance

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

[ref] csaProperties

Matrice che contiene i nomi delle proprietà da copiare nella nuova istanza.

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à specificate dell'oggetto specificato. Questo è il modo più efficiente per recuperare un'istanza specifica quando sono necessarie più proprietà rispetto alle chiavi. Tenere presente che non tutti i provider supportano operazioni di istanza parziale. In tal caso, l'intera istanza (incluse le chiavi) viene 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

GetInstanceKeysByPath

Condividi tramite