OleSave
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função Salva um objeto aberto no modo transacionado para o objeto armazenamento especificado.
Syntax
WINOLEAPI OleSave(
IPersistStorage* pPS,
IStorage* pStg,
BOOL fSameAsLoad
);
Parameters
- pPS
[no] Ponteiro para o IPersistStorage interface sobre o objeto a ser salvo.
- pStg
[no] Ponteiro para o IStorage interface no objeto armazenamento de destino que o objeto indicado na pPS deve ser salvo.
- fSameAsLoad
[no] Boolean que está definido como TRUE se pStg é o mesmo objeto armazenamento da qual o objeto foi carregado ou criado ou para FALSE se pstg foi carregado ou criado de um objeto armazenamento diferentes.
Return Value
Essa função retorna S_OK se o objeto foi salvo.
Essa função retorna STG_E_MEDIUMFULL se o objeto não pôde ser salvo falta devido a de espaço em disco.
Essa função também pode retornar qualquer valor de erro retornado pelo IPersistStorage::Save método.
Remarks
Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.
O OleSave função auxiliar manipula o comum situação na qual um objeto é aberto no modo de transação e é, em seguida, ser salvo no objeto de armazenamento especificado que usa a implementação OLE-provided arquivo composto.
É significa modo transacionado que altera para o objeto armazenada em buffer até um do IStorage Métodos Confirmar Ou Reverter é chamado.
Os chamadores podem identificador outras situações, chamado de IPersistStorage e IStorage Interfaces diretamente.
OleSave faz o seguinte:
Chamadas de IPersist::GetClassID método para get a CLSID do objeto.
Grava o CLSID para o objeto armazenamento usando o WriteClassStg função.
Chamadas de IPersistStorage::Save método para salvar o objeto.
Se não tenha havido erros na salvar, chama o IStorage::Commit método para confirmação de alterações.
Observação
Os objetos estáticos são salvos em um chamado transmitir conteúdo.
Observação
Metarquivo estático objetos get salvo em "formato de metarquivo de colocação." Dados estáticos bitmap independente de dispositivo (DIB) Obtém salvo no formato arquivo bitmap independente de dispositivo (DIB).Esses formatos são definidos para ser os padrões OLE para metarquivo e bitmap independente de dispositivo (DIB).
Observação
Todos os dados transferidos usando um IStream interface ou um arquivo transferido usando IDataObject::GetDataHere Deve estar nesses formatos.
Observação
Além disso, todos os objetos cujo formato arquivo usar como padrão é um metarquivo ou bitmap independente de dispositivo (DIB) devem gravar seus dados em um transmitir conteúdo usando esses padrão formatos.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | ole2.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
Automation Functions
IPersistStorage
IStorage
IPersistStorage::Save
IStorage
WriteClassStg
IPersistStorage::Save
IStorage::Commit
IStream
IDataObject::GetDataHere