RpcNsBindingInqEntryName 函数 (rpcdce.h)

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

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

语法

RPC_STATUS RpcNsBindingInqEntryName(
  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 函数来解除分配该内存。

条目名称仅与从 RpcNsBindingImportNextRpcNsBindingLookupNextRpcNsBindingSelect 函数返回的绑定句柄相关联。

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

要求

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

另请参阅

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree