Метод IPersistStream::Load (objidl.h)

Статья
08/25/2023

Инициализирует объект из потока, в котором он был сохранен ранее.

Синтаксис

HRESULT Load(
  [in] IStream *pStm
);

Параметры

[in] pStm

Указатель IStream на поток, из которого должен быть загружен объект.

Возвращаемое значение

Этот метод может возвращать следующие значения.

Код возврата	Описание
S_OK	Метод завершился успешно.
E_OUTOFMEMORY	Объект не был загружен из-за нехватки памяти.
E_FAIL	Объект не был загружен по какой-либо причине, кроме нехватки памяти.

Этот метод загружает объект из связанного потока. Указатель поиска задается так, как это было в последнем методе IPersistStream::Save . Этот метод может искать и считывать данные из потока, но не может выполнять запись в него.

Примечания к вызывающим абонентам

Вместо вызова IPersistStream::Load напрямую функция OleLoadFromStream обычно выполняет следующие действия:

Вызывает функцию ReadClassStm для получения идентификатора класса из потока.
Вызывает функцию CoCreateInstance для создания экземпляра объекта .
Запрашивает экземпляр для IPersistStream.
Вызывает IPersistStream::Load.

Функция OleLoadFromStream предполагает, что объекты хранятся в потоке с идентификатором класса, за которым следуют данные объекта. Этот шаблон хранения используется универсальной реализацией составного моникера, предоставляемой OLE.

Если объекты не хранятся с помощью этого шаблона, необходимо вызывать методы отдельно.

Заметки о моникере URL-адреса

Инициализирует моникер URL-адреса из данных в потоке, обычно хранимых ранее, с помощью IPersistStream::Save (с помощью OleSaveToStream). Двоичный формат моникера URL-адреса — это строка URL-адреса в Юникоде (может быть полной или частичной строкой URL-адреса. Дополнительные сведения см. в разделе CreateURLMonikerEx ). Это число символов ULONG , за которым следует несколько символов Юникода.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	objidl.h

См. также раздел

IPersistStream

Поделиться через