共用方式為

GetTempPathA 函式 （fileapi.h）

  • 發行項

擷取針對暫存盤指定之目錄的路徑。

語法

DWORD GetTempPathA(
  [in]  DWORD nBufferLength,
  [out] LPSTR lpBuffer
);

參數

[in] nBufferLength

TCHARs中，lpBuffer所識別的字串緩衝區大小。

[out] lpBuffer

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

傳回值

如果函式成功，傳回值會是複製到 lpBuffer之字串的長度，TCHAR，不包含終止的 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 通訊協定 是的
SMB 3.0 透明故障轉移 （TFO） 是的
具有向外延展檔案共用的SMB 3.0（SO） 是的
叢集共用磁碟區檔案系統 （CsvFS） 是的
復原檔案系統 （ReFS） 是的
 

例子

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

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平臺 窗戶
標頭 fileapi.h （包括 Windows.h）
連結庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

檔案管理功能

GetTempFileName

符號連結