通过

RpcNsGroupMbrInqBeginA 函数 （rpcnsi.h）

  • 项目

RpcNsGroupMbrInqBegin 函数创建用于查看组成员的查询上下文。

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

语法

RPC_STATUS RpcNsGroupMbrInqBeginA(
  unsigned long GroupNameSyntax,
  RPC_CSTR      GroupName,
  unsigned long MemberNameSyntax,
  RPC_NS_HANDLE *InquiryContext
);

参数

GroupNameSyntax

GroupName的语法。

若要使用注册表值项 HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax中指定的语法，请提供一个RPC_C_NS_SYNTAX_DEFAULT值。

GroupName

指向要查看的 RPC 组的名称的指针。

MemberNameSyntax

RpcNsGroupMbrInqNext 函数中返回参数 MemberName的语法。

若要使用注册表值项 HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax中指定的语法，请提供一个RPC_C_NS_SYNTAX_DEFAULT值。

InquiryContext

返回指向名称服务句柄的指针，该句柄与 RpcNsGroupMbrInqNext 和 RpcNsGroupMbrInqDone 函数一起使用。

返回值

价值 意义
RPC_S_OK
 调用成功。
RPC_S_INVALID_NAME_SYNTAX
 名称语法无效。
RPC_S_UNSUPPORTED_NAME_SYNTAX
 不支持名称语法。
RPC_S_INCOMPLETE_NAME
 名称不完整。
RPC_S_ENTRY_NOT_FOUND
 找不到名称服务条目。
RPC_S_NAME_SERVICE_UNAVAILABLE
 名称服务不可用。
 
注释 有关有效错误代码的列表，请参阅 RPC 返回值。
 

言论

RpcNsGroupMbrInqBegin 函数创建一个查询上下文，用于查看 RPC 组的成员。 在调用 RpcNsGroupMbrInqNext之前，应用程序必须先调用 RpcNsGroupMbrInqBegin 来创建查询上下文。 查看 RPC 组成员后，应用程序将调用 RpcNsGroupMbrInqDone 以删除查询上下文。

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

注意

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

要求

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

另请参阅

RpcNsGroupMbrAdd

RpcNsGroupMbrInqDone

RpcNsGroupMbrInqNext