getTempFileNameA 函式 (fileapi.h)

建立暫存檔案的名稱。如果產生唯一的檔案名，則會建立空的檔案，並釋放它的控制碼;否則，只會產生檔案名。

語法

UINT GetTempFileNameA(
  [in]  LPCSTR lpPathName,
  [in]  LPCSTR lpPrefixString,
  [in]  UINT   uUnique,
  [out] LPSTR  lpTempFileName
);

[in] lpPathName

檔案名的目錄路徑。應用程式通常會為目前目錄或 GetTempPath 函式的結果指定句點 (.) 。字串不能超過 MAX_PATH-14個字元，否則 GetTempFileName 將會失敗。如果此參數為 Null，則函式會失敗。

[in] lpPrefixString

以 Null 結尾的前置詞字串。此函式最多會使用此字串的前三個字元做為檔案名的前置詞。此字串必須包含 OEM 定義字元集中的字元。

[in] uUnique

要用來建立暫存檔案名的不帶正負號整數。如需詳細資訊，請參閱＜備註＞。

如果 uUnique 為零，函式會嘗試使用目前的系統時間來形成唯一的檔案名。如果檔案已經存在，數位就會增加一個，而且函式會測試此檔案是否已經存在。這會繼續直到找到唯一的檔案名為止;函式會依該名稱建立檔案，並加以關閉。請注意，當 uUnique 為非零時，函式不會嘗試驗證檔案名的唯一性。

[out] lpTempFileName

接收暫存檔案名之緩衝區的指標。此緩衝區應 MAX_PATH 字元，以容納路徑加上終止的 Null 字元。

如果函式成功，傳回值會指定暫存檔案名中使用的唯一數值。如果 uUnique 參數為非零值，則傳回值會指定相同的數位。

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

以下是可能的傳回值。

傳回值	描述
ERROR_BUFFER_OVERFLOW	lpPathName參數所指向的字串長度超過MAX_PATH–14 個字元。

GetTempFileName函式會建立下列格式的暫存檔案名：

< 路徑 >\< 前置 >< uuuu >。Tmp

下表描述檔案名語法。

如果 uUnique 為零， GetTempFileName 會建立空的檔案並加以關閉。如果 uUnique 不是零，您必須自行建立檔案。只會建立檔案名，因為 GetTempFileName 無法保證檔案名是唯一的。

只會使用 uUnique 參數的較低 16 位。如果lpPathName和lpPrefixString參數維持不變，這會將GetTempFileName限制為最多 65，535 個唯一檔案名。

由於用來產生檔案名的演算法， GetTempFileName 在建立具有相同前置詞的大量檔案時，效能不佳。在這種情況下，建議您根據 GUID來建構唯一的檔案名。

此函式已建立名稱的暫存檔案不會自動刪除。若要刪除這些檔案，請呼叫 DeleteFile。

若要避免轉換 ANSI 字串時所產生的問題，應用程式應該呼叫 CreateFile 函式來建立暫存檔案。

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

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

注意

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


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