Compartilhar via


Método IOleClientSite::SaveObject (oleidl.h)

Salva o objeto inserido associado ao site do cliente. Essa função é síncrona; no momento em que retornar, o salvamento será concluído.

Sintaxe

HRESULT SaveObject();

Retornar valor

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
E_FAIL
A operação falhou.

Comentários

Um objeto inserido chama SaveObject para solicitar que seu contêiner o salve no armazenamento persistente quando um usuário final escolher os comandos Atualização de Arquivo ou Sair. A chamada é síncrona, o que significa que, quando retornar, a operação de salvamento será concluída.

As chamadas para SaveObject ocorrem na maioria das implementações de IOleObject::Close. Normalmente, quando um contêiner informa a um objeto para fechar, o contêiner passa um sinalizador especificando se o objeto deve se salvar antes de fechar, solicitar instruções ao usuário ou fechar sem se salvar. Se um objeto for instruído a se salvar, seja por seu contêiner ou por um usuário final, ele chamará SaveObject para pedir ao aplicativo de contêiner para salvar o conteúdo do objeto antes que o objeto se feche. Se um contêiner instruir um objeto a não se salvar, o objeto não deve chamar SaveObject.

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 oleidl.h

Confira também

Ioleclientsite

IOleObject::Close