На главную

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 | Скачать Вниз

GetFullPathName



The GetFullPathName function retrieves the full path and filename of a specified file.

DWORD GetFullPathName(

LPCTSTR lpFileName, // address of name of file to find path for
DWORD nBufferLength, // size, in characters, of path buffer
LPTSTR lpBuffer, // address of path buffer
LPTSTR *lpFilePart // address of filename in path
);


Parameters

lpFileName

Points to a null-terminated string that specifies a valid filename. This string can use either short (the 8.3 form) or long filenames.

nBufferLength

Specifies the size, in characters, of the buffer for the drive and path.

lpBuffer

Points to a buffer that contains the null-terminated string for the name of the drive and path.

lpFilePart

Points to a variable that receives the address (in lpBuffer) of the final filename component in the path. This filename component is the long filename, if any, rather than the 8.3 form of the filename.



Return Values

If the GetFullPathName function succeeds, the return value is the length, in characters, of the string copied to lpBuffer, not including the terminating null character.
If the lpBuffer buffer is too small, the return value is the size of the buffer, in characters, required to hold the path.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The GetFullPathName function merges the name of the current drive and directory with the specified filename to determine the full path and filename of the specified file. It also calculates the address of the filename portion of the full path and filename. This function does not verify that the resulting path and filename are valid or that they refer to an existing file on the associated volume.

See Also

GetShortPathName, GetTempPath, SearchPath


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetFullPathName



Функция GetFullPathName извлекает полный путь и filename определенного файла.

DWORD GetFullPathName(

LPCTSTR lpFileName, // АДРЕС имени файла, чтобы находить путь для DWORD nBufferLength, // размера, в символах, буфера пути LPTSTR lpBuffer, // адрес буфера пути LPTSTR *адрес lpFilePart // filename в пути
);


Параметры

lpFileName

Точки на недействительный расторгнутую строку, которые определяют правильный filename. Эта строка может использовать или перемычка ( 8.3 форм) или длинные filenames.

nBufferLength

Определяет размер, в символах, буфера для проезда и пути.

lpBuffer

Точки на буфер, которые содержат недействительный расторгнутой строке для имени проезда и пути.

lpFilePart

Точки на переменную, которые получают адрес (в lpBuffer) конечного filename компонента в пути. Это filename компонент - длинный filename, если имеется в наличии, а не 8.3 форм filename.



Обратные Величины

Если функция GetFullPathName добивается успеха, обратная величина является длиной, в символах, строки скопированной на lpBuffer, не включая завершающий недействительный символ.
Если буфер lpBuffer слишком небольшой, обратная величина является размером буфера, в символах, требовавшихся, чтобы держать путь.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Функция GetFullPathName объединяет имя текущего накопителя и директория с определенным filename, чтобы определять полный путь и filename определенного файла. Это также вычисляет адрес части filename полного пути и filename. Эта функция не проверяет, что результирующий путь и filename будет в силе или, что они ссшлются на существующий файл в связанном объеме.

Смотри Также

GetShortPathName, GetTempPath, SearchPath


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