IPersistFile_Load

指定したファイルを開き、その内容からオブジェクトを初期化する。

IPersistFile_Load this, pszFileName, dwMode

this : [comobj] IPersistFile インターフェースの COM オブジェクト変数
pszFileName : [wstr] 開くファイルの絶対パス。
dwMode : [int] ファイルを開くときに使用するアクセスモード。取り得る値は STGM 列挙子から来る。必要に応じてより制限的なアクセス権を追加してよいため、メソッドはこの値を提案として扱える。dwMode が 0 の場合、実装はユーザーがファイルを開くときに使われる既定のアクセス権で開くべきである。

(プラグイン / モジュール : com_misc.dll)

解説

指定したファイルを開き、その内容からオブジェクトを初期化する。

[戻り値]
このメソッドは以下の値を返すことがある。
（以下省略）

[備考]
IPersistFile::Load
は指定されたファイルからオブジェクトを読み込む。このメソッドは初期化のみ行い、エンドユーザーにオブジェクトを表示するわけではない。ユーザーが
[ファイルを開く] コマンドを選択したときに行われることとは等価ではない。呼び出し側へのメモ ファイルモニカの BindToObject
メソッドは、モニカのバインド操作中（リンクされたオブジェクトが実行されるとき）にオブジェクトを読み込むためにこのメソッドを呼び出す。通常、アプリケーションがこのメソッドを直接呼び出すことはない。実装者へのメモ
ファイルを開くのに必要な情報はアプリケーションによって大きく異なるため、このメソッドを実装するオブジェクト自身が pszFileName
パラメーターで指定されたファイルを開かなければならない。これは IPersistStorage::Load および
IPersistStream::Load
と異なる。それらでは呼び出し側がストレージやストリームを開き、開かれたストレージまたはストリームポインターをロードされたオブジェクトに渡す。通常
OLE 複合ファイルを使用するアプリケーションの場合、IPersistFile::Load の実装は単に StgOpenStorage
関数を呼び出して指定されたファイル内のストレージオブジェクトを開けばよい。その後通常の初期化を進められる。ストレージオブジェクトを使用しないアプリケーションは通常のファイルを開く手順を実行できる。オブジェクトが読み込まれたら、実装はオブジェクトをランニングオブジェクトテーブルに登録するべきである（IRunningObjectTable::Register
を参照）。

情報