Função OleConvertIStorageToOLESTREAMEx (ole2.h)

Artigo
02/29/2024

A função OleConvertIStorageToOLESTREAMEx converte o objeto de armazenamento especificado do armazenamento estruturado OLE 2 para o modelo de objeto de armazenamento OLE 1, incluindo os dados de apresentação. Essa é uma das várias funções incluídas no Armazenamento Estruturado para garantir a compatibilidade entre OLE1 e OLE2.

Sintaxe

HRESULT OleConvertIStorageToOLESTREAMEx(
  [in]  LPSTORAGE   pstg,
  [in]  CLIPFORMAT  cfFormat,
  [in]  LONG        lWidth,
  [in]  LONG        lHeight,
  [in]  DWORD       dwSize,
  [in]  LPSTGMEDIUM pmedium,
  [out] LPOLESTREAM polestm
);

Parâmetros

[in] pstg

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

[in] cfFormat

Formato dos dados da apresentação. Pode ser NULL; nesse caso, os parâmetros lWidth, lHeight, dwSize e pmedium são ignorados.

[in] lWidth

Largura dos dados de apresentação do objeto em unidades HIMETRIC.

[in] lHeight

Altura dos dados de apresentação do objeto em unidades HIMETRIC.

[in] dwSize

Tamanho dos dados, em bytes, a serem convertidos.

[in] pmedium

Ponteiro para a estrutura STGMEDIUM para os dados serializados a serem convertidos.

[out] polestm

Ponteiro para um fluxo 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

A função OleConvertIStorageToOLESTREAMEx converte um objeto de armazenamento OLE 2 no formato OLE 1. Ela difere da função OleConvertIStorageToOLESTREAM , pois a função OleConvertIStorageToOLESTREAMEx também passa os dados da apresentação para o objeto de armazenamento OLE 1, enquanto a função OleConvertIStorageToOLESTREAM não.

Como OleConvertIStorageToOLESTREAMEx pode especificar quais dados de apresentação converter, eles podem ser usados por aplicativos que não usam recursos de cache padrão OLE, mas usam recursos de conversão do OLE.

O valor do membro tymed de STGMEDIUM deve ser TYMED_HGLOBAL ou TYMED_ISTREAM; consulte a enumeração TYMED para obter mais informações. O meio não é liberado pela 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