RpcNsProfileDeleteA 函数 (rpcnsi.h)

RpcNsProfileDelete 函数删除配置文件属性。

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

语法

RPC_STATUS RpcNsProfileDeleteA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName
);

参数

ProfileNameSyntax

指示下一个参数的语法的整数值,ProfileName

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

ProfileName

指向要删除的配置文件名称的指针。

返回值

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

言论

RpcNsProfileDelete 函数从指定的名称服务项(ProfileName)中删除配置文件属性。 既 ProfileName 也没有删除每个配置文件元素中作为成员包含的条目名称。

注意 谨慎使用 RpcNsProfileDelete;删除配置文件可能会产生破坏配置文件层次结构的不需要的效果。
 
注意 Microsoft定位符不支持此 DCE 函数。 Windows NT 和 Windows 2000 仅支持将此函数与 Cell Directory 服务(CDS)配合使用。
 

注意

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

要求

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

另请参阅

RpcNsProfileEltAdd

RpcNsProfileEltRemove