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 返回值。
注解
RpcNsBindingInqEntryName 函数返回客户端兼容绑定句柄从中获取的名称服务数据库条目名称。
RPC 运行时库为 EntryName 参数中返回的字符串分配内存。 应用程序负责调用 RpcStringFree 函数来解除分配该内存。
条目名称仅与从 RpcNsBindingImportNext、 RpcNsBindingLookupNext 和 RpcNsBindingSelect 函数返回的绑定句柄相关联。
例如，如果 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 |