Função OleConvertIStorageToOLESTREAM (ole2.h)

  • Artigo

A função OleConvertIStorageToOLESTREAM converte o objeto de armazenamento especificado do armazenamento estruturado OLE 2 para o modelo de objeto de armazenamento OLE 1, mas não inclui os dados de apresentação. Essa é uma das várias funções de compatibilidade.

Sintaxe

HRESULT OleConvertIStorageToOLESTREAM(
  [in]  LPSTORAGE   pstg,
  [out] LPOLESTREAM lpolestream
);

Parâmetros

[in] pstg

Ponteiro para a interface IStorage no objeto de armazenamento a ser convertido em um armazenamento OLE 1.

[out] lpolestream

Ponteiro para uma estrutura de fluxo OLE 1 em que a representação persistente do objeto é salva usando o modelo de armazenamento OLE 1.

Retornar valor

Essa função dá suporte ao valor retornado padrão E_INVALIDARG, além do seguinte:

Comentários

Essa função converte um objeto de armazenamento OLE 2 no formato OLE 1. O código de estrutura OLESTREAM implementado para OLE 1 deve estar disponível.

Na entrada, o fluxo para o qual os pontos lpolestm devem ser criados e posicionados da mesma forma que seria para uma chamada OleSaveToStream . Na saída, o fluxo contém a representação persistente do objeto usando o armazenamento OLE 1.

Nota Os objetos Paintbrush são tratados de forma diferente de outros objetos porque seus dados nativos estão no formato DIB (bitmap independente do dispositivo). Quando objetos Paintbrush são convertidos usando OleConvertIStorageToOLESTREAM, nenhum dado de apresentação é adicionado à estrutura OLESTREAM . Para incluir dados de apresentação, use a função OleConvertIStorageToOLESTREAMEx .
 

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 ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

CoIsOle1Class

OleConvertIStorageToOLESTREAMEx

OleConvertOLESTREAMToIStorage

OleConvertOLESTREAMToIStorageEx