IInitializeWithFile：：Initialize 方法 (propsys.h)

使用文件路径初始化处理程序。

语法

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

[in] pszFilePath

类型： LPCWSTR

指向缓冲区的指针，该缓冲区包含以 null 结尾的 Unicode 字符串的文件路径。

[in] grfMode

类型：DWORD

以下 STGM 值之一，指示 pszFilePath 的访问模式。

IInitializeWithFile：：Initialize 指示的文件是只读的。

IInitializeWithFile：：Initialize 指示的文件可以从中读取和写入。

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

初始化优先于此方法，因为它能够使用无法通过 Win32 路径访问的文件，例如文件扩展名为 .zip 的压缩文件的内容。仅当处理程序用于访问文件的 API 仅接受文件路径时，才使用 IInitializeWithFile：：Initialize 。

pszFilePath 指向的文件必须在处理程序的生存期内保持打开状态，或者在调用 IPropertyStore：：Commit 之前保持打开状态。

如果无法根据方法的参数值打开文件，此方法将返回合适的错误代码。

处理程序实例在其生存期内应只初始化一次。调用应用程序尝试重新初始化处理程序应会导致错误 HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)。