RpcBindingToStringBindingW 函数 (rpcdce.h)

  • 项目

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

语法

RPC_STATUS RpcBindingToStringBindingW(
  RPC_BINDING_HANDLE Binding,
  RPC_WSTR           *StringBinding
);

parameters

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 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 rpcdce.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

请参阅

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree