На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz