getTempPathW 函式 (fileapi.h)

擷取為臨時檔指定的目錄路徑。

語法

DWORD GetTempPathW(
  [in]  DWORD  nBufferLength,
  [out] LPWSTR lpBuffer
);

參數

[in] nBufferLength

TCHAR 中由 lpBuffer 識別的字串緩衝區大小。

[out] lpBuffer

字串緩衝區的指標，接收指定暫存盤路徑的 Null 終止字串。 傳回的字串以反斜杠結尾，例如 “C：\TEMP\”。

傳回值

如果函式成功，傳回值會是複製到 lpBuffer 之字串的長度，不包含終止的 Null 字元。 如果傳回值大於 nBufferLength，則傳回值是保存路徑所需的緩衝區長度，以 TCHAR 為單位。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

可能的傳回值上限為 MAX_PATH+1 (261) 。

備註

注意

應用程式應該呼叫 GetTempPath2 ，而不是 GetTempPath。

GetTempPath 函式會依下列順序檢查環境變數是否存在，並使用找到的第一個路徑：

1. TMP 環境變數指定的路徑。
2. TEMP 環境變數指定的路徑。
3. USERPROFILE 環境變數指定的路徑。
4. Windows 目錄。

請注意，函式不會驗證路徑是否存在，也不會測試目前進程是否具有路徑的任何訪問許可權。 GetTempPath 函式會傳回格式正確的字串，此字串會根據先前指定的環境變數搜尋順序來指定完整路徑。 應用程式應該先確認路徑是否存在，並在任何檔案 I/O 作業使用之前，先確認路徑是否具有適當的訪問許可權。

符號連結行為—如果路徑指向符號連結，暫存路徑名稱會維護任何符號連結。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。

技術	支援
伺服器消息塊 (SMB) 3.0 通訊協定	Yes
SMB 3.0 透明故障轉移 (TFO)	Yes
具有向外延展檔案共用的SMB 3.0 (SO)	Yes
叢集共用磁碟區文件系統 (CsvFS)	Yes
彈性檔案系統 (ReFS)	是

 

範例

如需範例，請參閱 建立和使用暫存盤。

注意

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

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	fileapi.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

檔案管理功能

GetTempFileName

符號連結