NetFileEnum功能提供有关服务器上某些或所有打开文件的信息,允许用户提供一个简历句柄,并通过重复调用函数获取所需的信息。
安全要求
只有管??理员或帐户操作员本地组的成员才能成功执行NetFileEnum.
NET_API_STATUS NetFileEnum(
LPTSTR【服务器名称】, | |
LPTSTR【基本路径】, | |
LPTSTR【用户名】, | |
DWORD【水平】, | |
LPBYTE【* bufptrig】, | |
DWORD【prefmaxlen】, | |
LPDWORD【entriesread】, | |
LPDWORD【为totalEntries】, | |
LPDWORD【resume_handle】 | |
); |
参数
【服务器名称】
指向包含要执行该函数的远程服务器名称的Unicode字符串。NULL指针或字符串指定本地计算机。
【基本路径】
指向包含返回信息限定符的Unicode字符串。如果为NULL,则枚举所有打开的资源。如果不为NULL,该函数仅枚举具有【基本路径】作为前缀的资源。A 【字首】是直到反斜杠的路径组件。
【用户名】
指向指定用户名称的Unicode字符串的指针。如果不为NULL,则【用户名】充当枚举的限定词。返回的文件仅限于具有与限定符匹配的用户名的文件。如果【用户名】为NULL,则不使用用户名限定符。
【水平】
指定以下值之一来返回【bufptrig】参数中指向的信息级别。
值 | 含义 |
2 | 返回文件识别号码。返回的缓冲区将包含FILE_INFO_2结构的数组。 |
3 | 返回有关该文件的信息。返回的缓冲区将包含FILE_INFO_3结构的数组。 |
【bufptrig】
指向返回信息结构的地址。
【prefmaxlen】
返回数据的最大长度(以8位为单位)。
【entriesread】
指向包含实际枚举元素数的DWORD的指针。
【为totalEntries】
指向DWORD的指针,其中包含可以从当前恢复位置枚举的条目总数。
【resume_handle】
指向DWORD,其中包含用于继续现有文件搜索的简历句柄【,】.句柄在第一个通话时应为零,对于后续调用保持不变。如果【resume_handle】为NULL,则不存储恢复句柄。
也可以看看