SHGetSpecialFolderLocation 函式 (shlobj_core.h)
[SHGetSpecialFolderLocation 不受支持,未來可能會變更或無法使用。 請改用 SHGetFolderLocation。]
擷取特殊資料夾 之ITEMIDLIST 結構的指標。
語法
HRESULT SHGetSpecialFolderLocation(
[in] HWND hwnd,
[in] int csidl,
[out] PIDLIST_ABSOLUTE *ppidl
);
參數
[in] hwnd
類型: HWND
保留的。
[in] csidl
類型: int
CSIDL 值,可識別感興趣的資料夾。
[out] ppidl
類型: PIDLIST_ABSOLUTE*
PIDL,指定資料夾相對於桌面) (命名空間根目錄的位置。 呼叫應用程式會負責使用 CoTaskMemFree 釋放傳回的 IDList。
傳回值
類型: HRESULT
如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | shlobj_core.h (包含 Shlobj.h) |
程式庫 | Shell32.lib |
Dll | Shell32.dll (4.0 版或更新版本) |
API 集合 | ext-ms-win-shell-shell32-l1-2-1 (在 Windows 10 10.0.10240 版中引進) |