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

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

  • Статья

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

Синтаксис

HRESULT Load(
  [in] IStream *pStm
);

Параметры

[in] pStm

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

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

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

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

Комментарии

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

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

Вместо вызова IPersistStream::Load напрямую функция OleLoadFromStream обычно выполняет следующие действия:
  1. Вызывает функцию ReadClassStm для получения идентификатора класса из потока.
  2. Вызывает функцию CoCreateInstance для создания экземпляра объекта .
  3. Запрашивает экземпляр для IPersistStream.
  4. Вызывает 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