Função OleConvertOLESTREAMToIStorageEx (ole2.h)

Artigo
08/25/2023

A função OleConvertOLESTREAMToIStorageEx converte o objeto especificado do modelo de armazenamento OLE 1 em um objeto de armazenamento estruturado OLE 2, incluindo dados de apresentação. Essa é uma das várias funções de compatibilidade.

Sintaxe

HRESULT OleConvertOLESTREAMToIStorageEx(
  [in]  LPOLESTREAM polestm,
  [out] LPSTORAGE   pstg,
  [out] CLIPFORMAT  *pcfFormat,
  [out] LONG        *plwWidth,
  [out] LONG        *plHeight,
  [out] DWORD       *pdwSize,
  [out] LPSTGMEDIUM pmedium
);

Parâmetros

[in] polestm

Ponteiro para o fluxo que contém a representação persistente do objeto no formato de armazenamento OLE 1.

[out] pstg

Ponteiro para o objeto de armazenamento estruturado OLE 2.

[out] pcfFormat

Ponteiro para onde o formato dos dados da apresentação é retornado. Pode ser NULL, indicando a ausência de dados de apresentação.

[out] plwWidth

Ponteiro para onde o valor de largura (em HIMETRIC) dos dados de apresentação é retornado.

[out] plHeight

Ponteiro para onde o valor de altura (em HIMETRIC) dos dados de apresentação é retornado.

[out] pdwSize

Ponteiro para onde o tamanho em bytes dos dados convertidos é retornado.

[out] pmedium

Ponteiro para onde a estrutura STGMEDIUM para os dados serializados convertidos é retornada.

Retornar valor

Essa função retorna HRESULT.

Comentários

Essa função converte um objeto OLE 1 em um objeto de armazenamento estruturado OLE 2. Você pode usar essa função para atualizar objetos OLE 1 para objetos OLE 2 quando uma nova versão do aplicativo de objeto dá suporte ao OLE 2.

Essa função difere da função OleConvertOLESTREAMToIStorage , na qual os dados de apresentação lidos da estrutura OLESTREAM são passados e o objeto de armazenamento OLE 2 recém-criado não contém um fluxo de apresentação.

Como essa função pode especificar quais dados de apresentação converter, ela pode ser usada por aplicativos que não usam os recursos de cache padrão do OLE, mas usam os recursos de conversão.

O membro tymed de STGMEDIUM só pode ser TYMED_NULL ou TYMED_ISTREAM. Se for TYMED_NULL, os dados serão retornados em um identificador global por meio do membro hGlobal de STGMEDIUM, caso contrário, os dados serão gravados no membro pstm dessa estrutura.

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