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 仅支持将此函数与单元格目录服务 (CDS) 配合使用。
 

注意

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

要求

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

另请参阅

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree