IPersistFolder3：：InitializeEx 方法 (shobjidl_core.h)

  • 發行項

初始化資料夾，並指定其在命名空間中的位置。 如果資料夾是快捷方式，這個方法也會指定目標資料夾的位置。

語法

HRESULT InitializeEx(
  [in] IBindCtx                         *pbc,
  [in] PCIDLIST_ABSOLUTE                pidlRoot,
  [in] const PERSIST_FOLDER_TARGET_INFO *ppfti
);

參數

[in] pbc

類型： IBindCtx*

提供系結內容的 IBindCtx 物件的指標。 此參數可以是 Null。

[in] pidlRoot

類型： LPCITEMIDLIST

完整 PIDL 的指標，指定資料夾或資料夾快捷方式的絕對位置。 呼叫的應用程式負責配置並釋放此 PIDL。

[in] ppfti

類型： const PERSIST_FOLDER_TARGET_INFO*

指定目標資料夾位置及其屬性之 PERSIST_FOLDER_TARGET_INFO 結構的指標。

如果 ppfti 指向有效的結構， pidlRoot 代表資料夾快捷方式。

如果 ppfti 設定為 NULL，pidlRoot 代表一般資料夾。 在此情況下， InitializeEx 的行為應該如同已呼叫 Initialize 一樣。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

此函式是 IPersistFolder：：Initialize 的擴充版本。 它可讓Shell初始化資料夾快捷方式和一般資料夾。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 SP3、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)
Dll Shell32.dll (5.0 版或更新版本)