Método IPersistStorage::IsDirty (objidl.h)

  • Artigo

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

Confira também

Ipersiststorage