RpcBindingFromStringBindingW 函数 (rpcdce.h)

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

语法

RPC_STATUS RpcBindingFromStringBindingW(
  RPC_WSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

parameters

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

请参阅

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose