Share via

SHGetSpecialFolderPathA 函式 (shlobj_core.h)

  • 發行項

[不支援SHGetSpecialFolderPath 。 請改用 SHGetFolderPath。]

擷取由其 CSIDL 識別之特殊資料夾的路徑。

語法

BOOL SHGetSpecialFolderPathA(
        HWND  hwnd,
  [out] LPSTR pszPath,
  [in]  int   csidl,
  [in]  BOOL  fCreate
);

參數

hwnd

類型： HWND

保留的。

[out] pszPath

類型： LPTSTR

接收指定資料夾之磁碟驅動器和路徑之 Null 終止字串的指標。 此緩衝區的大小必須至少MAX_PATH個字元。

[in] csidl

類型： int

識別相關資料夾的 CSIDL 。 如果指定了虛擬資料夾，此函式將會失敗。

[in] fCreate

類型： BOOL

指出如果資料夾不存在，是否應該建立資料夾。 如果此值為非零值，則會建立資料夾。 如果此值為零，則不會建立資料夾。

傳回值

類型： BOOL

如果成功，則為TRUE;否則為 FALSE。

備註

必須安裝 Microsoft Internet Explorer 4.0 Desktop Update，才能使用此函式。

注意

shlobj_core.h 標頭會將SHGetSpecialFolderPath定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或Unicode版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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