通过

RpcNsProfileEltRemoveA 函数 （rpcnsi.h）

  • 项目

RpcNsProfileEltRemove 函数从配置文件中删除元素。

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

语法

RPC_STATUS RpcNsProfileEltRemoveA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName
);

参数

ProfileNameSyntax

ProfileName的语法。

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

ProfileName

指向要从中删除元素的配置文件的名称的指针。

IfId

指向要删除的配置文件元素的接口标识的指针。

指定 null 值以删除默认配置文件成员。

MemberNameSyntax

MemberName的语法。

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

MemberName

指向要删除的配置文件元素中名称服务项名称的指针。

返回值

价值 意义
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 返回值。
 

言论

RpcNsProfileEltRemove 函数从 ProfileName 条目中的配置文件属性中删除配置文件元素。 此函数需要完全匹配 MemberName，并 IfId 参数来删除配置文件元素。 不会删除作为配置文件元素中的成员包含的条目（MemberName）。

注意 谨慎使用 RpcNsProfileEltRemov e：从配置文件中删除元素可能会产生破坏配置文件层次结构的不需要效果。
 
注意 Windows 2000 Active Directory 支持此函数。 早期版本的 Windows NT 仅支持将此函数与 Cell Directory 服务（CDS）配合使用。
 

注意

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

要求

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

另请参阅

RpcNsProfileDelete

RpcNsProfileEltAdd