Função OleSaveToStream (ole.h)
Salva um objeto com a interface IPersistStream nele no fluxo especificado.
Sintaxe
OLESTATUS OleSaveToStream(
LPOLEOBJECT unnamedParam1,
LPOLESTREAM unnamedParam2
);
Parâmetros
unnamedParam1
Ponteiro para a interface IPersistStream no objeto a ser salvo no fluxo. O parâmetro pPStm não pode ser NULL.
unnamedParam2
Ponteiro para a interface IStream no fluxo no qual o objeto deve ser salvo.
Retornar valor
Essa função retorna S_OK com êxito. Outros valores possíveis incluem o seguinte.
Código de retorno | Descrição |
---|---|
|
O objeto não pôde ser salvo devido à falta de espaço em disco. |
|
O parâmetro pPStm é NULL. |
Essa função também pode retornar qualquer um dos valores de erro retornados pela função WriteClassStm ou pelo método IPersistStream::Save .
Comentários
Essa função simplifica salvar um objeto que implementa a interface IPersistStream em um fluxo. Nesse fluxo, o CLSID do objeto precede seus dados. Quando o fluxo é recuperado, o CLSID permite que o código adequado seja associado aos dados. A função OleSaveToStream faz o seguinte:
- Chama o método IPersist::GetClassID para obter o CLSID do objeto.
- Grava o CLSID no fluxo com a função WriteClassStm .
- Chama o método IPersistStream::Save com fClearDirty definido como TRUE, o que limpa o bit sujo no objeto .
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 | ole.h (inclua Ole2.h) |
Biblioteca | Ole32.lib |
DLL | Ole32.dll |
Conjunto de APIs | ext-ms-win-com-ole32-l1-1-1 (introduzido em Windows 8.1) |