通过

RpcBindingToStringBindingW 函数 （rpcdce.h）

  • 项目

RpcBindingToStringBinding 函数返回绑定句柄的字符串表示形式。

语法

RPC_STATUS RpcBindingToStringBindingW(
  RPC_BINDING_HANDLE Binding,
  RPC_WSTR           *StringBinding
);

参数

Binding

要转换为绑定句柄的字符串表示形式的客户端或服务器绑定句柄。

StringBinding

返回指向指向 Binding 参数中指定的绑定句柄字符串表示形式的指针的指针。

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

返回值

价值 意义
RPC_S_OK
 调用成功。
RPC_S_INVALID_BINDING
 绑定句柄无效。
 
注释 有关有效错误代码的列表，请参阅 RPC 返回值。
 

言论

RpcBindingToStringBinding 函数将客户端或服务器绑定句柄转换为其字符串表示形式。

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

如果 Binding 参数中的绑定句柄包含 nil 对象 UUID，则返回的字符串中不包含对象 UUID 字段。

若要分析返回的 StringBinding 参数，请调用 RpcStringBindingParse 函数。

注意 查询客户端地址时，应用程序首先调用 RpcBindingServerFromClient 函数以获取部分绑定的服务器绑定句柄。 服务器绑定句柄可用于通过调用 RpcBindingToStringBinding 来获取字符串绑定。 然后，服务器可以调用 RpcStringBindingParse，从字符串绑定中提取客户端的网络地址。
 

注意

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

要求

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

另请参阅

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree