rpcStringBindingParse 函数 (rpcdce.h)

  • 项目

RpcStringBindingParse 函数将对象 UUID 部分和字符串绑定的地址部分作为单独的字符串返回。 应用程序调用 RpcStringBindingParse ，将绑定句柄的字符串表示形式解析为其组件字段。 RpcStringBindingParse 函数将对象 UUID 部分和字符串绑定的地址部分作为单独的字符串返回。

语法

RPC_STATUS RpcStringBindingParse(
  RPC_CSTR StringBinding,
  RPC_CSTR *ObjUuid,
  RPC_CSTR *Protseq,
  RPC_CSTR *NetworkAddr,
  RPC_CSTR *Endpoint,
  RPC_CSTR *NetworkOptions
);

参数

StringBinding

指向绑定的 以 null 结尾的字符串表示形式的指针。

ObjUuid

返回指向指向对象 UUID 的以 null 结尾的字符串表示形式的指针的指针。

指定 NULL 值以防止 RpcStringBindingParse 返回 ObjectUuid 参数。 在这种情况下，应用程序不调用 RpcStringFree。

Protseq

返回指向指向协议序列的 以 null 结尾的字符串表示形式的指针的指针。 有关 Microsoft RPC 支持的协议序列的列表，请参阅 字符串绑定。

指定 NULL 值以防止 RpcStringBindingParse 返回 ProtSeq 参数。 在这种情况下，应用程序不调用 RpcStringFree。

NetworkAddr

返回指向指向以 null 结尾的网络地址字符串表示形式的指针的指针。 指定 NULL 值以防止 RpcStringBindingParse 返回 NetworkAddr 参数。 在这种情况下，应用程序不调用 RpcStringFree。

Endpoint

返回指向终结点以 null 结尾的字符串表示形式的指针的指针。 指定 NULL 值以防止 RpcStringBindingParse 返回 EndPoint 参数。 在这种情况下，应用程序不调用 RpcStringFree。

NetworkOptions

返回指向以 null 结尾的网络选项字符串表示形式的指针的指针。

指定 NULL 值以防止 RpcStringBindingParse 返回 NetworkOptions 参数。 在这种情况下，应用程序不调用 RpcStringFree。

返回值

值 含义
RPC_S_OK
 调用成功。
RPC_S_INVALID_STRING_BINDING
 字符串绑定无效。
 
注意 有关有效错误代码的列表，请参阅 RPC 返回值。
 

注解

应用程序调用 RpcStringBindingParse 例程，将绑定句柄的字符串表示形式分析为其组件字段。

RPC 运行时库为返回的每个组件字符串分配内存。 应用程序负责为每个返回的字符串调用 RpcStringFree 一次，以解除分配该字符串的内存。

如果 StringBinding 参数的任何字段为空， RpcStringBindingParse 将在相应的输出参数中返回空字符串 (\0) 。

注意 若要查询客户端的地址，应用程序首先调用 RpcBindingServerFromClient 函数以获取部分绑定的服务器绑定句柄。 服务器绑定句柄可用于通过调用 RpcBindingToStringBinding 来获取字符串绑定。 然后，服务器可以调用 RpcStringBindingParse，以从字符串绑定中提取客户端的网络地址。
 

要求

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

另请参阅

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree