GetTempFileNameW

一時ファイル用の名前を作成する。一意のファイル名が生成された場合、空のファイルが作成され、そのハンドルが解放される。それ以外の場合、ファイル名のみが生成される。(GetTempFileNameW)

GetTempFileNameW lpPathName, lpPrefixString, uUnique, lpTempFileName

lpPathName : [wstr] ファイル名のディレクトリパス。アプリケーションは通常、現在のディレクトリにはピリオド (.) を、または GetTempPath 関数の結果を指定する。文字列は MAX_PATH?14 文字より長くすることはできない。そうでない場合 GetTempFileName は失敗する。このパラメータが NULL の場合、関数は失敗する。
lpPrefixString : [wstr] null 終端のプレフィックス文字列。関数はこの文字列の最初の 3 文字までをファイル名のプレフィックスとして使用する。この文字列は OEM 定義文字セットの文字で構成されなければならない。
uUnique : [int] 一時ファイル名の作成に使用される符号なし整数。詳細は備考を参照。uUnique が 0 の場合、関数は現在のシステム時刻を使用して一意のファイル名を作成しようとする。ファイルが既に存在する場合、番号は 1 つずつ増加し、関数はこのファイルが既に存在するかをテストする。これは一意のファイル名が見つかるまで続く。関数はその名前のファイルを作成して閉じる。uUnique が 0 以外の場合、関数はファイル名の一意性を検証しないことに注意する。
lpTempFileName : [wstr] 一時ファイル名を受け取るバッファへのポインタ。このバッファはパスと終端 null 文字を収容するために MAX_PATH 文字でなければならない。

(プラグイン / モジュール : kernel32.dll)

解説

一時ファイル用の名前を作成する。一意のファイル名が生成された場合、空のファイルが作成され、そのハンドルが解放される。それ以外の場合、ファイル名のみが生成される。(GetTempFileNameW)

[戻り値]
関数が成功した場合、戻り値は一時ファイル名で使用される一意の数値を指定する。uUnique パラメータが 0
以外の場合、戻り値は同じ番号を指定する。関数が失敗した場合、戻り値は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。
以下は可能な戻り値である。
（以下省略）

[備考]
GetTempFileName 関数は次の形式の一時ファイル名を作成する: <path>\<pre><uuuu>.TMP
以下の表はファイル名の構文を説明する。
（以下省略）

情報