Partilhar via

Função OleLoadFromStream (ole2.h)

  • Artigo

Carrega um objeto do fluxo.

Sintaxe

HRESULT OleLoadFromStream(
  [in]  LPSTREAM pStm,
  [in]  REFIID   iidInterface,
  [out] LPVOID   *ppvObj
);

Parâmetros

[in] pStm

Ponteiro para a interface IStream no fluxo do qual o objeto deve ser carregado.

[in] iidInterface

IID (identificador de interface) que o chamador deseja usar para se comunicar com o objeto depois que ele é carregado.

[out] ppvObj

Endereço da variável de ponteiro que recebe o ponteiro de interface solicitado em riid. Após o retorno bem-sucedido, *ppvObj contém o ponteiro de interface solicitado no objeto recém-carregado.

Retornar valor

Essa função retorna S_OK em caso de êxito. Outros valores possíveis incluem o seguinte.

Código de retorno Descrição
E_OUTOFMEMORY
 Memória insuficiente para a operação.
E_NOINTERFACE
 O objeto não dá suporte à interface especificada.
 

Essa função também pode retornar qualquer um dos valores de erro retornados pelas funções ReadClassStm e CoCreateInstance e pelo método IPersistStream::Load .

Comentários

Importante  

Observação de segurança: chamar esse método com dados não confiáveis é um risco à segurança. Chame esse método apenas quando você tiver dados confiáveis.

 
Essa função pode ser usada para carregar um objeto que dá suporte à interface IPersistStream . O CLSID do objeto deve preceder imediatamente os dados do objeto no fluxo, o que é realizado pela função complementar OleSaveToStream (ou pelas operações que ele encapsula, que são descritas sob esse tópico).

Se o CLSID do fluxo for CLSID_NULL, o parâmetro ppvObj será definido como NULL.

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 (inclua Ole2.h)
Biblioteca Ole32.lib
DLL Ole32.dll
Conjunto de APIs ext-ms-win-com-ole32-l1-1-5 (introduzido no Windows 10, versão 10.0.15063)

Confira também

Olesavetostream