通过

RpcBindingFromStringBindingW 函数 （rpcdce.h）

  • 项目

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

语法

RPC_STATUS RpcBindingFromStringBindingW(
  RPC_WSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

参数

StringBinding

指向绑定句柄的字符串表示形式的指针。

Binding

返回指向服务器绑定句柄的指针。

返回值

价值 意义
RPC_S_OK
 调用成功。
RPC_S_INVALID_STRING_BINDING
 字符串绑定无效。
RPC_S_PROTSEQ_NOT_SUPPORTED
 此主机上不支持协议序列。
RPC_S_INVALID_RPC_PROTSEQ
 协议序列无效。
RPC_S_INVALID_ENDPOINT_FORMAT
 终结点格式无效。
RPC_S_STRING_TOO_LONG
 字符串太长。
RPC_S_INVALID_NET_ADDR
 网络地址无效。
RPC_S_INVALID_ARG
 参数无效。
RPC_S_INVALID_NAF_ID
 网络地址系列标识符无效。
 
注释 有关有效错误代码的列表，请参阅 RPC 返回值。
 

言论

RpcBindingFromStringBinding 函数从绑定句柄的字符串表示形式创建服务器绑定句柄。 StringBinding 参数不必包含 UUID对象。 在这种情况下，返回的绑定包含 nil UUID。 如果提供的 StringBinding 参数不包含终结点字段，则返回的 Binding 参数是部分绑定的绑定句柄。 如果提供的 StringBinding 参数包含终结点字段，则终结点被视为已知终结点。 如果提供的 StringBinding 参数不包含主机地址字段，则返回的 Binding 参数引用本地主机。

应用程序通过调用 RpcStringBindingCompose 函数或提供字符串常量来创建字符串绑定。 此方法创建字符串绑定并不涉及与服务器联系。 API 的成功或失败不会指示服务器可用性。

使用 Binding 参数完成应用程序后，应用程序应调用 RpcBindingFree 函数来释放绑定句柄使用的内存。

注意

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

要求

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

另请参阅

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose