Share via


SHCreateShellFolderViewEx 函式 (shlobj_core.h)

建立預設 Shell 資料夾檢視物件的新實例。 建議您使用 SHCreateShellFolderView ,而不是此函式。

語法

SHSTDAPI SHCreateShellFolderViewEx(
  [in]  CSFV       *pcsfv,
  [out] IShellView **ppsv
);

參數

[in] pcsfv

類型: CSFV*

結構的指標,描述建立Shell資料夾檢視對象這個實例時所使用的詳細數據。

[out] ppsv

類型: IShellView**

當此函式成功傳回時, IShellView 介面指標的位址會指向新的檢視物件。 失敗時,此值為 NULL

傳回值

類型: HRESULT

如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

SHCreateShellFolderView 建議透過 SHCreateShellFolderViewEx ,因為其元素參與各種案例的彈性更高、為檢視提供新功能,以及與其他對象互動。

處理 IShellView 的數個實例時,您可能會想要確認哪一個是預設的 Shell 資料夾檢視物件。 若要這樣做,請使用 IID_CDefView 在物件上呼叫 QueryInterface 。 此呼叫只會在預設的 Shell 資料夾檢視物件上成功。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlobj_core.h (包含 Shlobj.h)
程式庫 Shell32.lib
Dll Shell32.dll (5.0 版或更新版本)

另請參閱

SHCreateShellFolderView