RpcNsBindingInqEntryNameW 函数（rpcdce.h）

项目
11/20/2024

RpcNsBindingInqEntryName 函数返回绑定句柄从中出现的条目名称。

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

语法

RPC_STATUS RpcNsBindingInqEntryNameW(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_WSTR           *EntryName
);

参数

Binding

返回名称服务数据库条目名称的绑定句柄。

EntryNameSyntax

EntryName中使用的语法。

使用注册表项中指定的语法

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax，提供RPC_C_NS_SYNTAX_DEFAULT值。

EntryName

返回指向在其中找到绑定的名称服务数据库项的名称的指针的地址。

指定 null 值以防止 RpcNsBindingInqEntryName 返回 EntryName 参数。在这种情况下，应用程序不会调用 RpcStringFree 函数。

返回值

价值	意义
RPC_S_OK	调用成功。
RPC_S_INVALID_BINDING	绑定句柄无效。
RPC_S_NO_ENTRY_NAME	绑定没有条目名称。
RPC_S_INVALID_NAME_SYNTAX	名称语法无效。
RPC_S_UNSUPPORTED_NAME_SYNTAX	不支持名称语法。
RPC_S_INCOMPLETE_NAME	名称不完整。

注释有关有效错误代码的列表，请参阅 RPC 返回值。

言论

RpcNsBindingInqEntryName 函数返回客户端兼容绑定句柄从中返回的名称服务数据库条目名称。

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

条目名称仅与从 RpcNsBindingImportNext、RpcNsBindingLookupNext和 RpcNsBindingSelect 函数返回的绑定句柄相关联。

如果未从名称服务数据库条目返回 Binding 参数中指定的绑定句柄（例如，如果绑定句柄是通过调用 RpcBindingFromStringBinding创建的），RpcNsBindingInqEntryName 返回空字符串（“\0”）和RPC_S_NO_ENTRY_NAME状态代码。

注意

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

要求

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