GetTempPath2A 函式 (fileapi.h)
根據呼叫程式的許可權,擷取為臨時檔指定的目錄路徑。
語法
DWORD GetTempPath2A(
[in] DWORD BufferLength,
[out] LPSTR Buffer
);
參數
[in] BufferLength
TCHAR 中由 lpBuffer 識別的字串緩衝區大小。
[out] Buffer
字串緩衝區的指標,接收指定暫存盤路徑的 Null 終止字串。 傳回的字串以反斜杠結尾,例如 “C:\TEMP\”。
傳回值
如果函式成功,傳回值會是複製到 lpBuffer 之字串的長度,不包括終止 Null 字元。 如果傳回值大於 nBufferLength,則傳回值會是保留路徑所需的緩衝區長度,以 TCHAR 為單位。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
可能的傳回值上限為 MAX_PATH+1 (261) 。
備註
從以 SYSTEM 身分執行的行程呼叫此函式時,它會傳回無法存取非 SYSTEM 進程的路徑 C:\Windows\SystemTemp。 對於非 SYSTEM 進程, GetTempPath2 的行為會與 GetTempPath 相同。
GetTempPath2 函式會依照下列順序檢查環境變數是否存在,並使用找到的第一個路徑:
- TMP 環境變數指定的路徑。
- TEMP 環境變數指定的路徑。
- USERPROFILE 環境變數指定的路徑。
- Windows 目錄。
符號連結行為: 如果路徑指向符號連結,暫存路徑名稱會維護任何符號連結。
在 Windows 8 和 Windows Server 2012 中,下列技術支援此函式。
技術 | 支援 |
---|---|
伺服器消息塊 (SMB) 3.0 通訊協定 | Yes |
SMB 3.0 透明故障轉移 (TFO) | Yes |
具有向外延展檔案共用的SMB 3.0 (SO) | Yes |
叢集共用磁碟區文件系統 (CsvFS) | Yes |
彈性檔案系統 (ReFS) | 是 |
範例
如需範例,請參閱 建立和使用臨時檔。
注意
fileapi.h 標頭會將 GetTempPath2 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 組建 20348 |
最低支援的伺服器 | Windows Server 組建 20348 |
標頭 | fileapi.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |