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

Inicializa un objeto de la secuencia donde se guardó anteriormente.

Sintaxis

HRESULT Load(
  [in] IStream *pStm
);

Parámetros

[in] pStm

Puntero IStream a la secuencia desde la que se debe cargar el objeto.

Valor devuelto

Este método puede devolver los valores siguientes.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_OUTOFMEMORY	El objeto no se cargó debido a la falta de memoria.
E_FAIL	El objeto no se cargó debido a algún motivo distinto de la falta de memoria.

Comentarios

Este método carga un objeto de su secuencia asociada. El puntero de búsqueda se establece tal y como estaba en el método IPersistStream::Save más reciente. Este método puede buscar y leer desde la secuencia, pero no puede escribir en él.

Notas a los autores de llamadas

En lugar de llamar directamente a IPersistStream::Load , normalmente se llama a la función OleLoadFromStream :

1. Llama a la función ReadClassStm para obtener el identificador de clase de la secuencia.
2. Llama a la función CoCreateInstance para crear una instancia del objeto .
3. Consulta la instancia de IPersistStream.
4. Llama a IPersistStream::Load.

La función OleLoadFromStream supone que los objetos se almacenan en la secuencia con un identificador de clase seguido de los datos del objeto. Ole usa este patrón de almacenamiento por la implementación genérica de moniker compuesto proporcionada por OLE.

Si los objetos no se almacenan con este patrón, debe llamar a los métodos por separado.

Notas del moniker de dirección URL

Inicializa un moniker de dirección URL desde datos dentro de una secuencia, normalmente almacenados allí anteriormente mediante su IPersistStream::Save (mediante OleSaveToStream). El formato binario del moniker de la dirección URL es su cadena url en Unicode (puede ser una cadena de dirección URL completa o parcial; consulte CreateURLMonikerEx para obtener más información). Se representa como un recuento de caracteres ULONG seguido de muchos caracteres Unicode.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	objidl.h

Consulte también

Ipersiststream