Metodo Provider::P utInstance(constCInstance&,long) (provider.h)

Articolo
03/01/2024

[La classe Provider fa parte di WMI Provider Framework che è ora considerata nello stato finale e non saranno disponibili ulteriori aggiornamenti, 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 PutInstance aggiorna un'istanza.

Sintassi

HRESULT PutInstance(
  [ref] const CInstance & newInstance,
        long              lFlags
);

Parametri

[ref] newInstance

Istanza aggiornata.

lFlags

Maschera di flag con informazioni sull'operazione di aggiornamento. Questo è il valore specificato dal client nel metodo IWbemServices::P utInstance .

Il flag seguente viene gestito da (e filtrato) da WMI:

WBEM_FLAG_RETURN_IMMEDIATELY

I valori lFlags validi sono:

WBEM_FLAG_CREATE_ONLY
WBEM_FLAG_CREATE_OR_UPDATE
WBEM_FLAG_UPDATE_ONLY

Valore restituito

L'implementazione predefinita del provider di framework di questo metodo restituisce WBEM_E_PROVIDER_NOT_CAPABLE al metodo chiamante. Il metodo IWbemServices::P utInstance elenca i valori restituiti più comuni, anche se è possibile scegliere di restituire qualsiasi codice restituito COM.

Commenti

WMI richiama PutInstance quando un client chiama IWbemServices::P utInstance sulla classe. È necessario implementare PutInstance se le istanze del provider di framework vengono aggiornate. L'elenco seguente descrive un'implementazione comune di PutInstance:

Esaminare le proprietà chiave passate dal client con i metodi Get per CInstance, ad esempio CInstance::GetCHString.
L'implementazione deve determinare se il provider supporta le modifiche richieste dal client.
Creare o aggiornare l'oggetto gestito appropriato, in base alle esigenze.
Restituisce il valore restituito appropriato.
Se il provider non supporta le modifiche richieste dal client, è necessario restituire un codice di errore appropriato. Per un elenco completo dei codici di errore validi, vedere IWbemServices::P utInstance.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	provider.h (includere FwCommon.h)
Libreria	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll

Condividi tramite