OleLoadFromStream

9/8/2008

Essa função carrega um objeto a partir de transmitir.

Syntax

WINOLEAPI OleLoadFromStream(
  IStream* pStm,
  REFIID iidInterface,
  void** ppvObj
);

Parameters

• pStm
  [no] Ponteiro para o IStream interface sobre a transmitir a partir da qual o objeto é para ser carregado.

• iidInterface
  [no] Identificador de interface (IID) o chamador deseja usar para se comunicar com o objeto quando ele é carregado.

• ppvObj
  [out] Endereço do ponteiro variável que recebe o ponteiro interface solicitado no riid. Após bem-sucedido retornar, ppvObj Contém o ponteiro interface solicitado sobre o objeto recém-carregado.

Return Value

O seguinte valores HRESULT podem ser retornados.

Valor	Descrição
S_OK	O objeto foi carregado.
E_NOINTERFACE	A interface especificada não é com suporte.
E_OUTOFMEMORY	Falha de função.

Essa função também pode retornar qualquer valor de erro retornado pelo ReadClassStm e CoCreateInstance funções e o IPersistStorage::Load método.

Remarks

Esta função pode ser usada para carregar um objeto que ofereça suporte a IPersistStream interface.

O CLSID do objeto deve preceder imediatamente dados do objeto na transmitir, que é conseguido a função complementar OleSaveToStream Ou as operações-quebra, que são descritas nesse tópico.

Se o CLSID para a transmitir é CLSID_NULL, o ppvObj parâmetro for definido como NULL.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	ole2.h
Library	ole32.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions
IStream
ReadClassStm
CoCreateInstance
IPersistStorage::Load
IPersistStreamInit
OleSaveToStream

Concepts

Determining Supported COM APIs