根據呼叫程式的許可權，擷取針對暫存盤指定的目錄路徑。
語法
DWORD GetTempPath2A(
[in] DWORD BufferLength,
[out] LPSTR Buffer
);
參數
[in] BufferLength
以 Buffer 標示的字串緩衝區大小，單位為 TCHAR。
[out] Buffer
字串緩衝區的指標，接收指定暫存盤路徑的 Null 終止字串。 傳回的字串以反斜杠結尾，例如 “C：\TEMP\”。
傳回值
若函式成功，回傳值即為複製至 Buffer 的字串長度（以 TCHARs），不含終止的空字元。 若回傳值大於 BufferLength，則回傳值即為維持該路徑所需緩衝區的長度（以 TCHARs）。
如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
可能的傳回值上限為 MAX_PATH+1 （261）。
言論
從以 SYSTEM 身分執行的行程呼叫此函式時，它會傳回無法存取非 SYSTEM 進程的路徑 C：\Windows\SystemTemp。 對於非 SYSTEM 進程，GetTempPath2 的行為會與 getTempPath 相同。
針對系統進程，GetTempPath2 函式會檢查環境變數是否存在 SystemTemp。 如果設定此環境變數，它會使用環境變數的值作為路徑，而不是 C: 磁碟驅動器上的預設系統提供路徑。
注意
GetTempPath2 存在的原因，而且預設會傳回 C：\Windows\SystemTemp，因為該目錄是 ACL，具有正確的許可權，以防止常見的路徑重新導向問題。 基於安全性考慮，僅將 SystemTemp 環境變數設定為只允許 SYSTEM 進程/系統管理員存取它的目錄。
對於非系統進程，GetTempPath2 函式會依下列順序檢查環境變數是否存在，並使用找到的第一個路徑：
- TMP 環境變數所指定的路徑。
- TEMP 環境變數所指定的路徑。
- USERPROFILE 環境變數所指定的路徑。
- Windows 目錄。
請注意，函式不會驗證路徑是否存在，也不會測試目前進程是否有任何類型的路徑訪問許可權。 GetTempPath2 函式會傳回格式正確的字串，根據先前指定的環境變數搜尋順序來指定完整路徑。 在檔案 I/O 作業的任何使用之前，應用程式應該先確認路徑是否存在，以及路徑的適當訪問許可權。
符號連結行為： 如果路徑指向符號連結，暫存路徑名稱會維護任何符號連結。
在 Windows 8 和 Windows Server 2012 中，下列技術支援此功能：
| 科技 | 支援 |
|---|---|
| 伺服器消息塊 （SMB） 3.0 通訊協定 | 是的 |
| SMB 3.0 透明故障轉移 （TFO） | 是的 |
| 具有向外延展檔案共用的SMB 3.0（SO） | 是的 |
| 叢集共用磁碟區檔案系統 （CsvFS） | 是的 |
| 復原檔案系統 （ReFS） | 是的 |
注意
安裝 2025 年 3 月和更新版本發行的 Windows 更新時，Windows 10 版本 1607 （組建 14393.7876） 和更新版本以及 Windows Server 2016 組建 14393.7876 和更新版本將支援此 API。 如需詳細資訊，請參閱 KB5053594 。
例子
如需範例，請參閱 建立和使用暫存盤。
注意
fileapi.h 標頭 會根據 UNICODE 預處理器常數的定義，將 getTempPath2 定義為自動選取此函式 ANSI 或 Unicode 版本的別名。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 11 組建 22000 |
| 支援的最低伺服器 | Windows Server 2022 內部版本 20348 |
| 標頭 | fileapi.h （包括 Windows.h） |
| 連結庫 | Kernel32.lib |
| DLL | Kernel32.dll |