GetTempPath2W 函式 (fileapi.h)

根據呼叫程式的許可權，擷取為臨時檔指定的目錄路徑。

語法

DWORD GetTempPath2W(
  [in]  DWORD  BufferLength,
  [out] LPWSTR 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 函式會依照下列順序檢查環境變數是否存在，並使用找到的第一個路徑：

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

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

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

如需範例，請參閱建立和使用臨時檔。

注意

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