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 モニカーのバイナリ形式は、Unicode の URL 文字列です (完全または部分的な URL 文字列である場合があります。詳細については、「 CreateURLMonikerEx 」を参照してください)。 これは、 ULONG の文字数の後に多数の Unicode 文字が続くものとして表されます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー objidl.h

こちらもご覧ください

IPersistStream