rpcNsGroupMbrInqBeginW 函数 (rpcnsi.h)

  • 项目

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

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

语法

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

注意

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

要求

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

另请参阅

RpcNsGroupMbrAdd

RpcNsGroupMbrInqDone

RpcNsGroupMbrInqNext