GetFullPathName

【勇芳软件工作室】汉化HomePreviousNext

GetFullPathName函数检索指定文件的完整路径和文件名。

DWORD GetFullPathName(

LPCTSTR 【lpFileName】,//找到路径的文件名的地址
DWORD 【nBufferLength】,//大小,字符,路径缓冲区
LPTSTR 【lpBuffer】,//路径缓冲区的地址
LPTSTR 【*lpFilePart】//路径中文件名的地址
); 

参数

【lpFileName】

指向一个空值终止的字符串,指定一个有效的文件名。该字符串可以使用短(8.3格式)或长文件名。

【nBufferLength】

指定驱动器和路径的缓冲区的大小(以字符为单位)。

【lpBuffer】

指向缓冲区,其中包含驱动器和路径的名称的以空值终止的字符串。

【lpFilePart】

指向接收路径中最终文件名组件的地址(在【lpBuffer】)中的变量。该文件名组件是长文件名(如果有的话),而不是文件名的8.3格式。

返回值

如果GetFullPathName函数成功,则返回值是复制到【lpBuffer】的字符串的长度(以字符为单位),不包括终止空字符。

如果【lpBuffer】缓冲区太小,则返回值是保存路径所需的缓冲区大小(以字符为单位)。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

GetFullPathName函数将当前驱动器和目录的名称与指定的文件名合并,以确定指定文件的完整路径和文件名。它还计算完整路径和文件名的文件名部分的地址。此函数不会验证生成的路径和文件名是否有效,或者它们是指相关卷上的现有文件。

也可以看看

GetShortPathName, GetTempPath, SearchPath