Método IPersistStorage::IsDirty (objidl.h)
Determina se um objeto foi alterado desde que foi salvo pela última vez em seu armazenamento atual.
Sintaxe
HRESULT IsDirty();
Retornar valor
Esse método retorna S_OK para indicar que o objeto foi alterado. Caso contrário, ele retornará S_FALSE.
Comentários
Use esse método para determinar se um objeto deve ser salvo antes de fechá-lo. O sinalizador sujo para um objeto é condicionalmente limpo no método IPersistStorage::Save.
Por exemplo, você pode otimizar uma operação de Salvamento de Arquivos chamando o método IPersistStorage::IsDirty para cada objeto e chamando o método IPersistStorage::Save somente para os objetos que são sujo.
Anotações para chamadores
Você deve tratar quaisquer códigos de retorno de erro como uma indicação de que o objeto foi alterado. A menos que esse método retorne explicitamente S_FALSE, suponha que o objeto deve ser salvo.Anotações aos implementadores
Um objeto sem objetos independentes simplesmente verifica seu sinalizador sujo para retornar o resultado apropriado.Um contêiner com um ou mais objetos contidos deve manter um sinalizador de sujo interno definido quando qualquer um de seus objetos contidos foi alterado desde que foi salvo pela última vez.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | objidl.h |