rpcBindingFromStringBindingA 函数 (rpcdce.h)
RpcBindingFromStringBinding 函数从绑定句柄的字符串表示形式返回绑定句柄。
语法
RPC_STATUS RpcBindingFromStringBindingA(
RPC_CSTR StringBinding,
RPC_BINDING_HANDLE *Binding
);
参数
StringBinding
指向绑定句柄的字符串表示形式的指针。
Binding
返回指向服务器绑定句柄的指针。
返回值
值 | 含义 |
---|---|
|
调用成功。 |
|
字符串绑定无效。 |
|
此主机上不支持协议序列。 |
|
协议序列无效。 |
|
终结点格式无效。 |
|
字符串太长。 |
|
网络地址无效。 |
|
参数无效。 |
|
网络地址系列标识符无效。 |
注解
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 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈