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 版或更新版本) |