共用方式為

GetTempPath2A 函式 （fileapi.h）

  • 發行項

根據呼叫程式的許可權，擷取針對暫存盤指定的目錄路徑。

語法

DWORD GetTempPath2A(
  [in]  DWORD BufferLength,
  [out] LPSTR Buffer
);

參數

[in] BufferLength

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

[out] Buffer

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

傳回值

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

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

可能的傳回值上限為 MAX_PATH+1 （261）。

言論

從以 SYSTEM 身分執行的行程呼叫此函式時，它會傳回無法存取非 SYSTEM 進程的路徑 C：\Windows\SystemTemp。 對於非 SYSTEM 進程，GetTempPath2 的行為會與 getTempPath 相同。

對於非系統進程，GetTempPath2 函式會依下列順序檢查環境變數是否存在，並使用找到的第一個路徑：

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

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

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

在 Windows 8 和 Windows Server 2012 中，下列技術支援此功能：

科技 支援
伺服器消息塊 （SMB） 3.0 通訊協定 是的
SMB 3.0 透明故障轉移 （TFO） 是的
具有向外延展檔案共用的SMB 3.0（SO） 是的
叢集共用磁碟區檔案系統 （CsvFS） 是的
復原檔案系統 （ReFS） 是的

例子

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

注意

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

要求

要求 價值
最低支援的用戶端 Windows 11 組建 22000
支援的最低伺服器 Windows Server 組建 20348
標頭 fileapi.h （包括 Windows.h）
連結庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

檔案管理功能

GetTempFileName

符號連結