Metodo Provider::P utInstance(IWbemClassObject*,long,MethodContext*) (provider.h)
[La classe Provider fa parte di WMI Provider Framework, che viene 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 PutInstance aggiorna un'istanza di .
Sintassi
HRESULT PutInstance(
IWbemClassObject *pInst,
long lFlags,
MethodContext *pContext
);
Parametri
pInst
TBD
lFlags
Maschera di bit dei 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
- WBEM_FLAG_CREATE_ONLY
- WBEM_FLAG_CREATE_OR_UPDATE
- WBEM_FLAG_UPDATE_ONLY
pContext
TBD
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 il provider del framework aggiorna le istanze. 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, se necessario.
-
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 (include FwCommon.h) |
Libreria | FrameDyn.lib |
DLL | FrameDynOS.dll; FrameDyn.dll |