Método IPersistStream::Load (objidl.h)

  • Artigo

Inicializa um objeto do fluxo em que ele foi salvo anteriormente.

Sintaxe

HRESULT Load(
  [in] IStream *pStm
);

Parâmetros

[in] pStm

Um ponteiro IStream para o fluxo do qual o objeto deve ser carregado.

Retornar valor

Esse método pode retornar os valores a seguir.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso.
E_OUTOFMEMORY
 O objeto não foi carregado devido à 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.

Comentários

Esse método carrega um objeto de seu fluxo associado. O ponteiro seek é definido como estava no método IPersistStream::Save mais recente. Esse método pode buscar e ler do fluxo, mas não pode gravar nele.

Anotações aos Chamadores

Em vez de chamar IPersistStream::Load diretamente, você normalmente chama a função OleLoadFromStream que faz o seguinte:
  1. Chama a função ReadClassStm para obter o identificador de classe do fluxo.
  2. Chama a função CoCreateInstance para criar uma instância do objeto .
  3. Consulta a instância de IPersistStream.
  4. Chama IPersistStream::Load.
A função OleLoadFromStream pressupõe que os objetos sejam armazenados no fluxo com um identificador de classe seguido pelos dados do objeto. Esse padrão de armazenamento é usado pela implementação genérica de moniker composto fornecida pelo OLE.

Se os objetos não forem armazenados usando esse padrão, você deverá chamar os métodos separadamente por conta própria.

Notas do Moniker de URL

Inicializa um moniker de URL de dados dentro de um fluxo, geralmente armazenado lá anteriormente usando seu IPersistStream::Save (usando OleSaveToStream). O formato binário do moniker de URL é sua cadeia de caracteres de URL em Unicode (pode ser uma cadeia de caracteres de URL completa ou parcial, consulte CreateURLMonikerEx para obter detalhes). Isso é representado como uma contagem ULONG de caracteres seguidos por tantos caracteres Unicode.

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 objidl.h

Confira também

Ipersiststream