IInitializeWithFile::Initialize メソッド (propsys.h)

ファイル パスを使用してハンドラーを初期化します。

構文

HRESULT Initialize(
  [in] LPCWSTR pszFilePath,
  [in] DWORD   grfMode
);

パラメーター

[in] pszFilePath

種類: LPCWSTR

null で終わる Unicode 文字列としてファイル パスを含むバッファーへのポインター。

[in] grfMode

型: DWORD

pszFilePath のアクセス モードを示す次の STGM 値のいずれか。

STGM_READ

IInitializeWithFile::Initialize によって示されるファイルは読み取り専用です。

STGM_READWRITE

IInitializeWithFile::Initialize によって示されるファイルの読み取りと書き込みが可能です。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

ファイル名拡張子が .zip 圧縮ファイルの内容など、Win32 パスを介してアクセスできないファイルを使用できるため、このメソッドに対して Initialize を使用することをお勧めします。 IInitializeWithFile::Initialize は、ファイルにアクセスするためにハンドラーによって使用される API がファイル パスのみを受け入れる場合にのみ使用します。

pszFilePath が指すファイルは、ハンドラーの有効期間中、または IPropertyStore::Commit が呼び出されるまで開いたままにする必要があります。

メソッドのパラメーター値に従ってファイルを開くことができない場合、このメソッドは適切なエラー コードを返します。

ハンドラー インスタンスは、有効期間内に 1 回だけ初期化する必要があります。 呼び出し元のアプリケーションがハンドラーを再初期化しようとすると、 エラーが発生 HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)します。

要件