Функция GetFullPathName извлекает полный путь и имя указанного файла.
Синтаксис
DWORD GetFullPathName( LPCTSTR lpFileName, // имя файла DWORD nBufferLength, // буфер размера пути LPTSTR lpBuffer, // буфер пути LPTSTR *lpFilePart // адрес имени файла в пути ); |
Параметры
lpFileName
[in] Указатель на символьную строку с нулем в конце, которая определяет допустимое имя файла. Эта символьная строка может использовать или короткие ( формы 8.3 ) или длинные имена файла.nBufferLength
[in] Размер буфера для приема строки с нулем в конце для диска и пути, в TCHARs (символах).lpBuffer
[out] Указатель на буфер, который получает символьную строку с нулем в конце для диска и пути.lpFilePart
[out] Указатель на буфер, который получает адрес (в lpBuffer) имени заключающего файла, как составляющей части в строке пути.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - длина символьной строки, в TCHARs, скопированной в lpBuffer, не включая символ завершения строки (нуль-терминатор).
Если буфер lpBuffer является слишком маленьким, чтобы содержать путь, возвращаемое значение - размер буфера, в TCHARs, необходимый, чтобы вместить путь. Поэтому, если возвращаемое значение больше, чем определено параметром nBufferLength, вызовите функцию снова с буфером, который является достаточно большим, чтобы вместить путь.
Если функция завершается с ошибкой по любой другой причине, величина возвращаемого значения - нуль. Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.
Замечания
Функция GetFullPathName соединяет имя текущего диска и каталога с указанным именем файла, чтобы установить полный путь и название указанного файла. Она также вычисляет адрес части с именем файла в полном пути и названия файла. Эта функция не проверяет, правильный ли итоговый путь и имя файла или относятся ли они к существующему файлу на связанном томе.
Функция GetFullPathName не делает никаких преобразований указанного имени файла в lpFileName. Если указанное имя файла существует, Вы можете использовать функции GetLongPathName и GetShortPathName, чтобы преобразовать его в длинное и короткое имя пути, соответственно.
Смотри также
Обзор Управление файлами, Функции, используемые в управлении файлами, GetLongPathName, GetShortPathName, GetTempPath, SearchPath
|
Размещение и совместимость GetFullPathName |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT Workstation |
Да |
| е |
Windows Me |
Да |
| н |
Windows 98 |
Да |
| т |
Windows 95 |
Да |
| С |
Windows Server 2003 |
Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да |
| в | ||
| е | ||
| р | ||
|
Используемая библиотека |
Kernel32.lib |
|
| Используемая DLL | - | |
| Заголовочный файл | ||
|
- объявлено в |
Winbase.h |
|
| - включено в |
Windows.h |
|
| Unicode |
Реализуется как версии Unicode и ANSI для Windows 2000/XP. Обратите внимание на то, что поддержка в Windows Me/98/95 требует программы Microsoft Layer for Unicode. |
|
| Замечания по платформе |
Не имеется |
|