PathUnExpandEnvStringsA 函式 （shlwapi.h）
將完整路徑中的特定資料夾名稱取代為其相關聯的環境字串。
語法
BOOL PathUnExpandEnvStringsA(
[in] LPCSTR pszPath,
[out] LPSTR pszBuf,
[in] UINT cchBuf
);
參數
[in] pszPath
類型：LPCTSTR
長度上限為 null 的字串指標MAX_PATH，其中包含要取消展開的路徑。
[out] pszBuf
類型：LPTSTR
緩衝區的指標，當這個方法傳回成功時，會收到未展開的字串。 此緩衝區的大小必須設定為 MAX_PATH，以確保大小足以保存傳回的字串。
[in] cchBuf
類型：UINT
pszBuf 緩衝區的大小，以字元為單位。
傳回值
類型：BOOL
如果成功，則會傳回 TRUE;否則，FALSE。
言論
下列資料夾路徑會由其相等的環境字串取代。
| 資料夾 | 環境字串 |
|---|---|
| [所有使用者] 設定檔資料夾 | %ALLUSERSPROFILE% |
| 目前使用者的應用程式資料資料資料夾（僅限 Windows Vista 和更新版本）。 | %APPDATA% |
| 系統名稱 | %COMPUTERNAME% |
| Program Files 資料夾 | %ProgramFiles% |
| 系統根資料夾 | %SystemRoot% |
| 系統驅動器號 | %SystemDrive% |
| 目前使用者的配置檔資料夾 | %USERPROFILE% |
附註 %APPDATA% 和 %USERPROFILE% 與撥打電話的用戶相對。 如果使用者正從服務模擬，則此函式無法運作。 如需存取控制問題的進一步討論，請參閱 存取控制。
注意
shlwapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 PathUnExpandEnvStrings 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional、Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | shlwapi.h |
| 連結庫 | Shlwapi.lib |
| DLL | Shlwapi.dll 版 （5.0 版或更新版本） |