SearchPath

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

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