Metodo Provider::Commit (provider.h)

Articolo
08/25/2023

[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 Commit viene usato per inviare un'istanza a WMI. Questo metodo è una funzione helper e non deve essere sottoposto a override.

Sintassi

HRESULT Commit(
  CInstance *pInstance,
  bool      bCache
);

Parametri

pInstance

Puntatore all'istanza da archiviare da WMI.

bCache

Indica se viene implementata una cache. Questo valore deve essere impostato su FALSE nella versione corrente del framework del provider.

Valore restituito

Usare le macro SUCCESSED o FAILED nell'HRESULT restituito per determinare se il metodo ha avuto esito positivo.

Commenti

Se il client annulla la query, il metodo Commit restituisce un errore. Un writer del provider può usare questo fatto per terminare un'enumerazione.

Questo metodo chiama anche CInstance::Release nel puntatore pInstance . A causa di questo, il provider di framework deve prestare attenzione a non chiamare di nuovo CInstance::Release. Ciò significa che un puntatore intelligente pInstance non è compatibile con questo metodo perché il puntatore intelligente chiama CInstance ::Release nel relativo distruttore.

Questo metodo deve essere usato solo quando il provider di framework non chiama CInstance ::Release nel puntatore pInstance separatamente e se il puntatore pInstance non è e non sarà mai, un puntatore intelligente.

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