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

  • [アーティクル]

指定したファイルを開き、ファイルに含まれているオブジェクトを初期化します。

構文

HRESULT Load(
  [in] LPCOLESTR pszFileName,
  [in] DWORD     dwMode
);

パラメーター

[in] pszFileName

開くファイルの絶対パス。

[in] dwMode

ファイルを開くときに使用するアクセス モード。 指定できる値は、 STGM 列挙から取得されます。 メソッドは、この値を提案として扱い、必要に応じてより制限の厳しいアクセス許可を追加できます。 dwMode が 0 の場合、実装では、ユーザーがファイルを開いたときに使用される既定のアクセス許可を使用してファイルを開く必要があります。

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_OUTOFMEMORY
 メモリ不足のため、オブジェクトを読み込めませんでした。
E_FAIL
 メモリ不足以外の何らかの理由でオブジェクトを読み込めませんでした。

注釈

IPersistFile::Load は、指定したファイルからオブジェクトを読み込みます。 このメソッドは初期化専用であり、オブジェクトをエンド ユーザーに表示しません。 これは、ユーザーが [ファイルを開く ] コマンドを選択したときに発生する処理と同じではありません。

呼び出し元へのメモ

ファイル モニカーの BindToObject メソッドはこのメソッドを呼び出して、モニカー バインド操作中 (リンク オブジェクトが実行されている場合) にオブジェクトを読み込みます。 通常、アプリケーションはこのメソッドを直接呼び出しません。

実装者へのメモ

ファイルを開くために必要な情報はアプリケーションによって大きく異なるため、このメソッドを実装するオブジェクトは pszFileName パラメーターで指定されたファイルも開く必要があります。 これは、呼び出し元がストレージまたはストリームを開き、開いているストレージまたはストリーム ポインターを読み込まれたオブジェクトに渡す IPersistStorage::Load および IPersistStream::Load とは異なります。

通常 OLE 複合ファイルを使用するアプリケーションの場合、 IPersistFile::Load 実装では StgOpenStorage 関数を呼び出して、指定したファイル内のストレージ オブジェクトを開くことができます。 その後、通常の初期化に進むことができます。 ストレージ オブジェクトを使用しないアプリケーションでは、通常のファイルを開く手順を実行できます。

オブジェクトが読み込まれると、実装では実行中のオブジェクト テーブルにオブジェクトを登録する必要があります ( 「IRunningObjectTable::Register」を参照)。

要件

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

こちらもご覧ください

IPersistFile