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) |