RpcNsEntryExpandNameW 函数 (rpcnsi.h)

  • 项目

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

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

语法

RPC_STATUS RpcNsEntryExpandNameW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName,
  RPC_WSTR      *ExpandedName
);

parameters

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 [仅限桌面应用]
目标平台 Windows
标头 rpcnsi.h (包括 Rpc.h)
Library Rpcns4.lib
DLL Rpcns4.dll

请参阅

RpcStringFree