GetTempFileName (Windows CE 5.0)
This function creates a name for a temporary file. The file name is the concatenation of specified path and prefix strings, a hexadecimal string formed from a specified integer, and the .TMP extension.
If you specify an integer other than zero, the function creates the file name but does not create the file. If you specify zero for the integer, the function creates a unique file name and creates the file in the specified directory.
UINT GetTempFileName(LPCTSTR lpPathName, LPCTSTR lpPrefixString, UINT uUnique, LPTSTR lpTempFileName);
Parameters
lpPathName
[in] Points to a null-terminated string that specifies the directory path for the file name. This string must consist of characters in the ANSI character set. Because the concept of a current directory does not exist in Windows CE, you must specify the full directory path. If this parameter is NULL, the function fails.lpPrefixString
[in] Points to a null-terminated prefix string. The function uses the first three characters of this string as the prefix of the file name. This string must consist of characters in the ANSI character set.uUnique
[in] Specifies an unsigned integer that the function converts to a hexadecimal string for use in creating the temporary file name.If uUnique is nonzero, the function appends the hexadecimal string to lpPrefixString to form the temporary file name. In this case, the function does not create the specified file, and does not test whether the file name is unique.
If uUnique is zero, the function uses a hexadecimal string derived from the current system time. In this case, the function uses different values until it finds a unique file name, and then it creates the file in the lpPathName directory.
lpTempFileName
[out] Points to the buffer that receives the temporary file name. This null-terminated string consists of characters in the ANSI character set. To accommodate the path, this buffer should be at least the length, in bytes, specified by MAX_PATH.
Return Values
If the function succeeds, the return value specifies the unique numeric value used in the temporary file name. If the uUnique parameter is nonzero, the return value specifies that same number.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
This function creates a temporary file name. The following code example shows the form of the temporary file name.
path\preuuuu.TMP
The following table describes the file name syntax.
| Component | Description |
|---|---|
| path | Path specified by the lpPathName parameter. |
| pre | First three letters of the lpPrefixString string. |
| uuuu | Hexadecimal value of uUnique. |
When a Windows CE-based device is powered down, temporary files whose names have been created by this function are not automatically deleted.
To avoid problems resulting from converting an ANSI character set string to a Windows string, an application should call the CreateFile function to create a temporary file.
If the uUnique parameter is zero, GetTempFileName attempts to form a unique number based on the current system time. If a file with the resulting file name exists, another number is generated and the test for existence is repeated. Testing continues until a unique file name is found. GetTempFileName then creates a file by that name and closes it. When uUnique is nonzero, no attempt is made to create and open the file.
Windows CE pads a file name with zeroes when it has fewer than four hexadecimal digits as part of its name. For example, Windows 2000 creates <File Name>34.tmp, while Windows CE creates <File Name>0034.tmp.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Winbase.h.
Link Library: Coredll.lib.
See Also
Send Feedback on this topic to the authors