Функция GetFullPathName


Функция 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.

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz