|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
GetTempFileName
The GetTempFileName function creates a name for a temporary file. The filename is the concatenation of specified path and prefix strings, a hexadecimal string formed from a specified integer, and the .TMP extension.
The specified integer can be nonzero, in which case, the function creates the filename but does not create the file. If you specify zero for the integer, the function creates a unique filename and creates the file in the specified directory.
UINT GetTempFileName(
LPCTSTR lpPathName, // address of directory name for temporary file LPCTSTR lpPrefixString, // address of filename prefix UINT uUnique, // number used to create temporary filename LPTSTR lpTempFileName // address of buffer that receives the new filename );
Parameters
lpPathName
Points to a null-terminated string that specifies the directory path for the filename. This string must consist of characters in the ANSI character set. Applications typically specify a period (.) or the result of the GetTempPath function for this parameter. If this parameter is NULL, the function fails.
lpPrefixString
Points to a null-terminated prefix string. The function uses the first three characters of this string as the prefix of the filename. This string must consist of characters in the ANSI character set.
uUnique
Specifies an unsigned integer that the function converts to a hexadecimal string for use in creating the temporary filename. If uUnique is nonzero, the function appends the hexadecimal string to lpPrefixString to form the temporary filename. In this case, the function does not create the specified file, and does not test whether the filename 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 filename, and then it creates the file in the lpPathName directory.
lpTempFileName
Points to the buffer that receives the temporary filename. This null-terminated string consists of characters in the ANSI character set. This buffer should be at least the length, in bytes, specified by MAX_PATH to accommodate the path.
Return Values
If the function succeeds, the return value specifies the unique numeric value used in the temporary filename. 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
The GetTempFileName function creates a temporary filename of the following form: path\preuuuu.TMP The following table describes the filename syntax:
Component Meaning path Path specified by the lpPathName parameter pre First three letters of the lpPrefixString string uuuu Hexadecimal value of uUnique
When Windows shuts 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 filename exists, the number is increased by one and the test for existence is repeated. Testing continues until a unique filename 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.
See Also
CreateFile, GetTempPath
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
GetTempFileName
Функция GetTempFileName создает называть в честь временного файла. filename - конкатенация определенного пути и префиксных строк, шестнадцатеричная строка формировалась из определенного целого, и расширения .TMP.
Определенное целое может быть ненулевым, в этом случае, функция создает filename но не создает файл. Если Вы определяете нуль для целого, функция создает уникальный filename и создает файл в определенном директории.
UINT GetTempFileName(
LPCTSTR lpPathName, // АДРЕС директория называет в честь временного файлового lpPrefixString LPCTSTR, // адреса filename префикса UINT uUnique, // числа использованных, чтобы создавать временный filename адрес LPTSTR lpTempFileName // буфера, который получает новый filename );
Параметры
lpPathName
Точки на недействительный расторгнутую строку, которые определяют путь директория для filename. Эта строка должна состоять из символов в наборе символов ANSI. Приложения обычно определяют период (.) или результат функции GetTempPath для этого параметра. Если этот параметр НЕДЕЙСТВИТЕЛЕН, функция терпит неудачу.
lpPrefixString
Точки на недействительный расторгнутую префиксную строку. Функция использует первые три типа этой строки как префикс filename. Эта строка должна состоять из символов в наборе символов ANSI.
uUnique
Определяет неподписанное целое, что функция преобразовывается в шестнадцатеричную строку для использования на создании временного filename. Если uUnique ненулевой, функция добавляет шестнадцатеричную строку в lpPrefixString, чтобы формировать временный filename. В этом случае, функция не создает определенный файл, и не тестирует независимо filename уникальное. Если uUnique - нуль, функция использует шестнадцатеричную строку производную от текущего системного времени. В этом случае, функция использует другие величины пока она не найдет уникальный filename, и затем это создает файл в директории lpPathName.
lpTempFileName
Точки на буфер, которые получают временный filename. Эта недействительный расторгнутая строка состоит из символов в наборе символов ANSI. Этот буфер должен быть по крайней мере длиной, в байтах, определенных MAX_PATH, чтобы размещать путь.
Обратные Величины
Если функция добивается успеха, обратная величина определяет уникальную числовую величину использованную во временном filename. Если параметр uUnique ненулевой, обратная величина определяет это то же число. Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.
Замечания
Функция GetTempFileName создает временный filename следующего формы: path\preuuuu.TMP СЛЕДУЮЩАЯ таблица описывает синтаксис filename:
Компонентное Значение Путь пути определенный параметром lpPathName pre Первые три письма lpPrefixString строки uuuu Шестнадцатеричная величина uUnique
Когда Windows отключает, временные файлы, чьи имена созданы этой функцией автоматически не удалены. Для того, чтобы избегать проблем проистекая от преобразования набора символов строки ANSI до строки Windows, приложение должно называть функцию CreateFile, чтобы создавать временный файл. Если параметр uUnique - нуль, попытки GetTempFileName, чтобы формировать уникальное число основанное в текущем системном времени. Если файл с результирующим filename существует, число повышено одним и тестом для существования повторен. Испытание остается пока уникальный filename не быть обнаружено. GetTempFileName ЗАТЕМ создает файл этим именем и закрывает это. Когда uUnique ненулевой, никакая попытка не сделана, чтобы создавать и открывать файл.
Смотри Также
CreateFile, GetTempPath
|
|
|
|
| |