通过

RpcStringBindingParseW 函数 （rpcdce.h）

  • 项目

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

语法

RPC_STATUS RpcStringBindingParseW(
  RPC_WSTR StringBinding,
  RPC_WSTR *ObjUuid,
  RPC_WSTR *Protseq,
  RPC_WSTR *NetworkAddr,
  RPC_WSTR *Endpoint,
  RPC_WSTR *NetworkOptions
);

参数

StringBinding

指向绑定的 null终止字符串表示形式的指针。

ObjUuid

返回指向 null终止的对象的字符串表示形式的指针 UUID。

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

Protseq

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

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

NetworkAddr

返回指向 null-terminated 字符串表示形式的指针的指针。 指定 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，从字符串绑定中提取客户端的网络地址。
 

注意

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

要求

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

另请参阅

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree