共用方式為

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 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlobj_core.h （包括 Shlobj.h， Shlobj_core.h）
連結庫 Shell32.lib
DLL Shell32.dll （4.71 版或更新版本）