RpcNsProfileEltRemoveW 函数 (rpcnsi.h)

  • 项目

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

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

语法

RPC_STATUS RpcNsProfileEltRemoveW(
  unsigned long ProfileNameSyntax,
  RPC_WSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_WSTR      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 条目的 profile 属性中删除配置文件元素。 此函数需要 与 MemberName 和 IfId 参数完全匹配才能删除配置文件元素。 不会删除作为成员包含在 profile 元素中的 member (MemberName) 项。

注意 请谨慎使用 RpcNsProfileEltRemove ：从配置文件中删除元素可能会产生破坏配置文件层次结构的不良影响。
 
注意 Windows 2000 Active Directory 支持此函数。 早期版本的 Windows NT 仅支持将此函数与单元格目录服务 (CDS) 配合使用。
 

注意

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

要求

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

另请参阅

RpcNsProfileDelete

RpcNsProfileEltAdd