通过

NetGetDisplayInformationIndex 函数 (lmaccess.h)

  • 项目

NetGetDisplayInformationIndex 函数返回第一个显示信息条目的索引，该条目的名称以指定的字符串开头，或者其名称按字母顺序跟在字符串后面。 可以使用此函数来确定对 NetQueryDisplayInformation 函数的后续调用的起始索引。

语法

NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex(
  [in]  LPCWSTR ServerName,
  [in]  DWORD   Level,
  [in]  LPCWSTR Prefix,
  [out] LPDWORD Index
);

parameters

[in] ServerName

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

[in] Level

指定要查询的帐户级别。 此参数的取值可为下列值之一：

值 含义
1
 查询所有本地和全局 (正常) 用户帐户。
2
 查询所有工作站和服务器用户帐户。
3
 查询所有全局组。

[in] Prefix

指向指定要搜索的前缀的字符串的指针。

[out] Index

指向接收所请求条目的索引的值的指针。

返回值

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

如果函数失败，则返回值可能是以下错误代码之一。

返回代码 说明
ERROR_ACCESS_DENIED
 用户无权访问请求的信息。
ERROR_INVALID_LEVEL
 为 Level 参数指定的值无效。
ERROR_NO_MORE_ITEMS
 没有更多的项目可以操作。
NERR_InvalidComputer
 计算机名称无效。

注解

如果在运行 Active Directory 的域控制器上调用此函数，则会根据 安全对象的访问控制列表 (ACL) 允许或拒绝访问。 默认 ACL 允许所有经过身份验证的用户和“Pre-Windows 2000 兼容访问”组的成员查看信息。 如果在成员服务器或工作站上调用此函数，则所有经过身份验证的用户都可以查看信息。 有关这些平台上的匿名访问和限制匿名访问的信息，请参阅 网络管理功能的安全要求。 有关 ACL、ACE 和访问令牌的详细信息，请参阅访问控制模型。

函数仅返回调用方具有读取访问权限的信息。 调用方必须具有对 Domain 对象的 List Contents 访问权限，并且对位于系统容器中的 SAM 服务器对象枚举整个 SAM 域访问权限。

要求

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

另请参阅

获取函数

NetQueryDisplayInformation

网络管理功能

网络管理概述