RpcNsBindingInqEntryNameA 函数 (rpcdce.h)

  • 项目

RpcNsBindingInqEntryName 函数返回绑定句柄来自的条目名称。

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

语法

RPC_STATUS RpcNsBindingInqEntryNameA(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_CSTR           *EntryName
);

参数

Binding

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

EntryNameSyntax

EntryName 中使用的语法。

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

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

EntryName

返回指向在其中找到 Binding 的 name-service 数据库条目名称的指针的地址。

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

另请参阅

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree