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 版中引進)