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 函数从指定的 name-service 条目中删除配置文件属性 (ProfileName) 。 不会删除 ProfileName 和每个配置文件元素中作为成员包含的条目名称。

注意 请谨慎使用 RpcNsProfileDelete ;删除配置文件可能会产生破坏配置文件层次结构的不良影响。
 
注意 Microsoft 定位符不支持此 DCE 函数。 Windows NT和 Windows 2000 仅支持将此函数与单元格目录服务 (CDS) 配合使用。
 

注意

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

要求

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

另请参阅

RpcNsProfileEltAdd

RpcNsProfileEltRemove