IPersistStream::Load

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/8/2008

Este método Inicializa um objeto a partir de transmitir onde ele foi salvo anteriormente.

Syntax

HRESULT Load(
  IStream* pStm 
);

Parameters

pStm
[no] IStream ponteiro para transmitir a partir do qual o objeto deve ser carregado.

Return Value

A seguinte tabela mostra os valores de retorno para este método.

Valor	Descrição
S_OK	O objeto foi carregado com êxito.
E_OUTOFMEMORY	O objeto não foi carregado devido a uma falta de memória.
E_FAIL	O objeto não foi carregado devido a algum motivo que não seja a falta de memória.

Remarks

Este método carrega um objeto de seu associado transmitir. O ponteiro de busca é definido como era no mais recente IPersistStream::Save método. Esse método pode buscar e ler a partir de transmitir, mas não é possível gravar nele.

Em sair, o ponteiro da busca deve ser deixado na mesma posição como era no sair de salvar, imediatamente após o final dos dados.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

Rather than chamado IPersistStream::Load diretamente, você geralmente chamar o OleLoadFromStream função faz o seguinte:

Chamadas de ReadClassStm função para get identificador de classe a partir de transmitir.
Chamadas de CoCreateInstance função para criar uma instância do objeto.
A instância para consultas IPersistStream.
Chamadas IPersistStream::Load.

O OleLoadFromStream função pressupõe que objetos são armazenados na transmitir com um identificador classe seguido de dados objeto. Esse padrão armazenamento é usado pelo genérico, composição-implementação moniker fornecida pelo OLE.

Se os objetos não são armazenados usando esse padrão, você deve chamar os métodos separadamente mesmo.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Compartilhar via