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)。