IPersistStorage::Load メソッド (objidl.h)

オブジェクトを既存のストレージから読み込みます。

構文

HRESULT Load(
  [in] IStorage *pStg
);

[in] pStg

オブジェクトの読み込み元となる既存のストレージへの IStorage ポインター。

このメソッドは、次の値を返すことができます。

リターンコード	説明
S_OK	メソッドは正常に完了しました。
CO_E_ALREADYINITIALIZED	オブジェクトは、IPersistStorage::Load メソッドまたは IPersistStorage::InitNew メソッドの以前の呼び出しによって既に初期化されています。
E_OUTOFMEMORY	メモリ不足のため、オブジェクトが読み込まれていませんでした。
E_FAIL	メモリ不足以外の何らかの理由により、オブジェクトが読み込まれていませんでした。

このメソッドは、既存のストレージからオブジェクトを初期化します。このメソッドがコンテナーアプリケーションによって呼び出された場合、オブジェクトは読み込まれた状態になります。既定のハンドラーによって呼び出された場合、このメソッドはオブジェクトを実行中の状態にします。

既定のハンドラーまたはオブジェクト自体は、オブジェクトの読み込み中または実行中に IStorage ポインターを保持できます。

IPersistStorage::Load を直接呼び出すのではなく、通常、OleLoad ヘルパー関数を呼び出すと、次の処理が行われます。

また、OleCreateFromData 関数または OleCreateFromFile 関数を呼び出して(ドラッグアンドドロップまたはクリップボードの貼り付け操作のように) オブジェクトを複合ファイルに挿入するときにも、このメソッドを間接的に呼び出します。

コンテナーは、オブジェクトに対する後の操作で使用するために、IPersistStorage ポインターをキャッシュする必要があります。

実装では、オブジェクトを読み込むには、次の手順を実行する必要があります。

手順 3 と 4 は、オブジェクトがメモリ不足の状況で自身を保存できるようにするために特に重要です。記憶域インターフェイスとストリームインターフェイスへのポインターを保持すると、メモリ不足のため、このストレージへの保存操作が失敗しないことが保証されます。

このメソッドの実装では、IPersistStorage::InitNew メソッドまたは IPersistStorage::Load メソッドの呼び出しが既に初期化された後に受け取った場合は、CO_E_ALREADYINITIALIZED エラーコードを返す必要があります。

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