通过

RpcNsGroupMbrAddA 函数 （rpcnsi.h）

  • 项目

RpcNsGroupMbrAdd 函数向组添加条目名称。 如有必要，它会创建该条目。

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

语法

RPC_STATUS RpcNsGroupMbrAddA(
  unsigned long GroupNameSyntax,
  RPC_CSTR      GroupName,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName
);

参数

GroupNameSyntax

GroupName的语法。

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

GroupName

指向要接收新成员的 RPC 组的名称的指针。

MemberNameSyntax

MemberName中使用的语法。

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

MemberName

指向新 RPC 组成员的名称的指针。

返回值

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

言论

RpcNsGroupMbrAdd 将名称服务数据库条目名称添加为 RPC 组属性的成员。

如果 GroupName 项不存在，RpcNsGroupMbrAdd 尝试使用组属性创建条目，并添加由 MemberName指定的组成员。 在这种情况下，应用程序必须具有创建条目的权限。 否则，具有必要权限的管理应用程序应在运行应用程序之前调用 RpcNsMgmtEntryCreate 来创建该条目。

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

注意

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

要求

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

另请参阅

RpcNsGroupMbrRemove

RpcNsMgmtEntryCreate