Metodo IPersistStorage::IsDirty (objidl.h)

Determina se un oggetto è stato modificato dopo l'ultimo salvataggio nella risorsa di archiviazione corrente.

Sintassi

HRESULT IsDirty();

Valore restituito

Questo metodo restituisce S_OK per indicare che l'oggetto è stato modificato. In caso contrario, restituisce S_FALSE.

Commenti

Utilizzare questo metodo per determinare se un oggetto deve essere salvato prima di chiuderlo. Il flag dirty per un oggetto viene cancellato in modo condizionale nel metodo IPersistStorage::Save .

Ad esempio, è possibile ottimizzare un'operazione di salvataggio file chiamando il metodo IPersistStorage::IsDirty per ogni oggetto e quindi chiamando il metodo IPersistStorage::Save solo per gli oggetti sporchi.

Note ai chiamanti

È consigliabile considerare eventuali codici restituiti di errore come un'indicazione che l'oggetto è stato modificato. A meno che questo metodo non restituisca in modo esplicito S_FALSE, si supponga che l'oggetto debba essere salvato.

Note per gli implementatori

Un oggetto senza oggetti contenuti controlla semplicemente il flag dirty per restituire il risultato appropriato.

Un contenitore con uno o più oggetti contenuti deve mantenere un flag dirty interno impostato quando uno dei relativi oggetti contenuti è stato modificato dall'ultimo salvataggio.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione objidl.h

Vedi anche

IPersistStorage