通过

RpcNsEntryExpandNameA 函数 （rpcnsi.h）

  • 项目

RpcNsEntryExpandName 函数扩展了名称服务条目名称。 Active Directory 支持此函数。

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

语法

RPC_STATUS RpcNsEntryExpandNameA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_CSTR      *ExpandedName
);

参数

EntryNameSyntax

EntryName的语法。

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

EntryName

指向要展开的条目名称的指针。

ExpandedName

返回指向 EntryName扩展版本的指针。

返回值

价值 意义
RPC_S_OK
 调用成功。
RPC_S_INCOMPLETE_NAME
 名称不完整。
 
注释 有关有效错误代码的列表，请参阅 RPC 返回值。
 

言论

应用程序调用 RpcNsEntryExpandName 函数以获取完全扩展的条目名称。

RPC 运行时库为返回的 ExpandedName 参数分配内存。 应用程序负责为返回的字符串调用 RpcStringFree 函数。

返回的扩展条目名称帐户用于本地名称转换，以及本地定义的命名架构的差异。

注意 此函数需要 Active Directory 支持。
 

注意

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

要求

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

另请参阅

RpcStringFree