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

返回指向指向对象 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，以从字符串绑定中提取客户端的网络地址。
 

注意

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

要求

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

另请参阅

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree