rpcBindingToStringBinding 函数 (rpcdce.h)

  • 项目

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

语法

RPC_STATUS RpcBindingToStringBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *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，以从字符串绑定中提取客户端的网络地址。
 

要求

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

另请参阅

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree