通过

RpcNsGroupMbrInqNextW 函数 （rpcnsi.h）

  • 项目

RpcNsGroupMbrInqNext 函数一次从组返回一个条目名称。

注意 Windows Vista 及更高版本的操作系统不支持此功能。
 

语法

RPC_STATUS RpcNsGroupMbrInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_WSTR      *MemberName
);

参数

InquiryContext

名称服务句柄。

MemberName

返回指向 RPC 组成员名称的指针的地址。 返回名称的语法是由 RpcNsGroupMbrInqBegin 函数中的 MemberNameSyntax 参数指定的。

指定 null 值以防止 RpcNsGroupMbrInqNext 返回 MemberName 参数。 在这种情况下，应用程序不会调用 RpcStringFree 函数。

返回值

价值 意义
RPC_S_OK
 调用成功。
RPC_S_INVALID_NS_HANDLE
 名称服务句柄无效。
RPC_S_NO_MORE_MEMBERS
 不再有成员。
RPC_S_NAME_SERVICE_UNAVAILABLE
 名称服务不可用。
 
注释 有关有效错误代码的列表，请参阅 RPC 返回值。
 

言论

RpcNsGroupMbrInqNext 函数返回 RpcNsGroupMbrInqBegin中由 GroupName 参数指定的 RPC 组的一个成员。 应用程序可以通过重复调用 rpcNsGroupMbrInqNext 来查看 RPC 组的所有成员。 查看所有组成员后，此函数将返回RPC_S_NO_MORE_MEMBERS状态代码。 返回的组成员是无序的。

每次调用返回成员名称 RpcNsGroupMbrInqNext 时，RPC 运行时库将为返回的 MemberName分配内存。 应用程序负责为每个返回 MemberName 字符串调用 RpcStringFree。 查看 RPC 组的成员后，应用程序必须调用 RpcNsGroupMbrInqDone 才能释放查询上下文。

对于每个组的查看，返回组成员的顺序可能有所不同。 这意味着每次运行应用程序时，组成员返回到应用程序的顺序可能有所不同。

注意 Windows 2000 Active Directory 支持此函数。 早期版本的 Windows NT 仅支持将此函数与 Cell Directory 服务（CDS）配合使用。
 

注意

rpcnsi.h 标头将 RpcNsGroupMbrInqNext 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 rpcnsi.h （包括 Rpc.h）
库 Rpcns4.lib
DLL Rpcns4.dll

另请参阅

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree