SearchPath

VB声明

Declare Function SearchPath Lib "kernel32" Alias "SearchPathA" (ByVal lpPath As String, ByVal lpFileName As String, ByVal lpExtension As String, ByVal nBufferLength As Long, ByVal lpBuffer As String, ByVal lpFilePart As String) As Long

SearchPath函数查找指定的文件。 参数：lpszPath 指定一个以NULL结束的字符串，该字符串指定要查找的文件的路径。若lpszPath参数为NULL，则该函数在下列目录中查找一个匹配的文件，下列目录以查找的先后序列出：

从其中装入应用程序的目录。 当前目录。 Windows系统目录。GetsystemDirectory函数检索这一目录的路径。 Windows目录。GetSystemDirectory函数检索这一目录的路径。 Path环境变量中列出的目录。 LpszFile 指向一个以NULL结束的字符串，该字符串指定要查找的文件名称。

LpszExtension 指向一个以NULL结束的字符串，该字符串指定查找该 文件时要添加到文件名之后的扩展名。扩展名的第一个字符必须是一个点（.）。仅当所指定的文件名没有以扩展名结束时，才添加扩展名。

若不需要扩展名或所指定的文件名中含有扩展名，则lpszExtension参数必须为NULL。

CchReturnBuffer 指定接收有效的路径和文件名的缓冲区的字符长度。

lpszReturnBuf fer 指向存放找到的文件的有效路径和文件名的缓冲区。

PlpszFilePart 指出有效路径和文件名的最后一个组成部分的地址。该地址是路径中紧接在最后一个反斜线之后第一个字符的地址，他指向文件名。

说明

查找指定文件

返回值

Long，装载到lpBuffer缓冲区的字符数。如缓冲区长度不足，则返回缓冲区必要的长度。零表示失败。会设置GetLastError

参数表

参数 类型及说明

lpPath String，欲搜索的路径。如果为vbNullString，则采用windows搜索路径。参考OpenFile函数的OFSTRUCT结构中对OF_SEARCH标志搜索顺序的介绍

lpFileName String，要查找的文件名

lpExtension String，文件扩展名。必须用一个句点符号起头。如文件没有扩展名，或者lpFileName包括了扩展名，则设为vbNullString

nBufferLength Long，lpBuffer字串的长度

lpBuffer String，用于装载文件名的一个字串

lpFilePart String，指定一个长整数变量，用于装载缓冲文件名部分的地址。在vb中不是特别有用

注解

参考GetFullPathName函数