SearchPath功能搜索指定的文件。
DWORD SearchPath(
LPCTSTR 【lpPath】, | //搜索路径的地址 |
LPCTSTR 【lpFileName】, | //文件名的地址 |
LPCTSTR 【lpExtension】, | //扩展名的地址 |
DWORD 【nBufferLength】, | //大小(以字符为单位)的缓冲区 |
LPTSTR 【lpBuffer】, | //找到文件名的缓冲区地址 |
LPTSTR *【lpFilePart】 | //指向文件组件的指针的地址 |
); |
参数
【lpPath】
指向以空字符结尾的字符串,指定要搜索文件的路径。如果此参数为NULL,则该函数按以下顺序搜索以下目录中的匹配文件:
1.应用程序加载的目录。
2.当前目录。
3.Windows 95: Windows系统目录。使用GetSystemDirectory函数获取此目录的路径。
Windows NT: 32位Windows系统目录。使用GetSystemDirectory函数获取此目录的路径。该目录的名称是SYSTEM32。
4.Windows NT: 16位Windows系统目录。没有获取此目录的路径的Win32函数,但它被搜索。该目录的名称是SYSTEM。
5.Windows目录。使用GetWindowsDirectory函数获取此目录的路径。
6. PATH环境变量中列出的目录。
【lpFileName】
指向一个以null结尾的字符串,指定要搜索的文件的名称。
【lpExtension】
指向一个以null结束的字符串,指定在搜索文件时添加到文件名的扩展名。文件扩展名的第一个字符必须是句点(。)。仅当指定的文件名不以扩展名结尾时,才会添加扩展名。
如果不需要文件扩展名,或者如果文件名包含扩展名,则此参数可以为NULL。
【nBufferLength】
指定接收有效路径和文件名的缓冲区的长度(以字符为单位)。
【lpBuffer】
指向缓冲区中找到的文件的有效路径和文件名。
【lpFilePart】
指向有效路径和文件名的最后一个组件的地址(【lpBuffer】),这是路径中最后一个反斜杠(\\)之后的字符的地址。
返回值
如果函数成功,则返回的值是复制到缓冲区的字符串的长度(以字符为单位),不包括终止空字符。如果返回值大于【nBufferLength】,则返回的值是保存路径所需的缓冲区的大小。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
也可以看看
FindFirstFile, FindNextFile, GetSystemDirectory, GetWindowsDirectory