通过

NetAccessEnum 函数 (lmaccess.h)

  • 项目

[此函数已过时。 有关备用函数的列表，请参阅 授权函数。]

不支持。

NetAccessEnum 函数检索有关每个访问权限记录的信息。

语法

NET_API_STATUS NET_API_FUNCTION NetAccessEnum(
  LPCWSTR servername,
  LPCWSTR BasePath,
  DWORD   Recursive,
  DWORD   level,
  LPBYTE  *bufptr,
  DWORD   prefmaxlen,
  LPDWORD entriesread,
  LPDWORD totalentries,
  LPDWORD resume_handle
);

参数

servername

指向字符串的指针，该字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。 如果此参数为 NULL，则使用本地计算机。

BasePath

指向包含资源基路径名的字符串的指针。 NULL 指针或 NULL 字符串表示不使用基路径。 可以将路径指定为通用命名约定 (UNC) pathname。

Recursive

指定启用或禁用递归搜索的标志。

如果此参数等于零， NetAccessEnum 函数将返回 pszBasePath 参数命名为基路径的资源的条目，以及该基路径正下方的资源的条目。

如果此参数为非零值，则函数将返回资源名称开头具有 pszBasePath 的所有访问控制列表 (ACL) 条目。

level

指定数据的信息级别。 此参数的取值可为下列值之一：

值 含义
0
 pbBuffer 参数指向access_info_0结构。
1
 pbBuffer 参数指向access_info_1结构。

bufptr

指向接收访问信息结构的缓冲区的指针。 此数据的格式取决于 sLevel 参数的值。

prefmaxlen

指定 pbBuffer 参数指向的缓冲区的大小（以字节为单位）。

entriesread

指向接收实际枚举元素计数的无符号短整数的指针。 仅当 NetAccessEnum 函数返回 NERR_Success 或 ERROR_MORE_DATA时，计数才有效。

totalentries

指向接收可能枚举的条目总数的无符号短整数的指针。 仅当 NetAccessEnum 函数返回 NERR_Success 或 ERROR_MORE_DATA时，计数才有效。

resume_handle

TBD

返回值

如果函数成功，则返回值 NERR_Success。

如果函数失败，则返回值为系统错误代码。 有关错误代码的列表，请参阅 系统错误代码。

注解

此函数需要管理员特权才能在启用了本地安全性的计算机上成功执行。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 lmaccess.h (包括 Lm.h、Lmaccess.h)
Library Netapi32.lib
DLL Netapi32.dll

另请参阅

授权函数