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 |