rpcdce.h) (RPC_BINDING_HANDLE_TEMPLATE_V1_W 结构

  • 项目

RPC_BINDING_HANDLE_TEMPLATE_V1 结构包含用于创建 RPC 绑定句柄的基本选项。

语法

typedef struct _RPC_BINDING_HANDLE_TEMPLATE_V1_W {
  unsigned long  Version;
  unsigned long  Flags;
  unsigned long  ProtocolSequence;
  unsigned short *NetworkAddress;
  unsigned short *StringEndpoint;
  union {
    unsigned short *Reserved;
  } u1;
  UUID           ObjectUuid;
} RPC_BINDING_HANDLE_TEMPLATE_V1_W, *PRPC_BINDING_HANDLE_TEMPLATE_V1_W;

成员

Version

此结构的版本。 对于 RPC_BINDING_HANDLE_TEMPLATE_V1 必须将其设置为 1。

Flags

标记描述 RPC 模板的特定属性的值。

值 含义
RPC_BHT_OBJECT_UUID_VALID
 ObjectUuid 成员包含有效值。 如果未设置此标志，则 ObjectUuid 成员不包含有效的 UUID。

ProtocolSequence

与此绑定句柄关联的 协议序列字符串文本 。 可以是下列值之一。

ncalrpc - 指定本地 RPC。 ncacn_ip_tcp - 指定基于 TCP/IP 的 RPC。 ncacn_np - 通过命名管道指定 RPC。 ncacn_http - 指定 RPC over HTTP。

NetworkAddress

指向要绑定到的网络地址的字符串表示形式的指针。

StringEndpoint

指向要绑定到的终结点的字符串表示形式的指针。 如果使用动态终结点，请将此成员设置为 NULL。 解析终结点后，使用 RpcBindingToStringBinding 获取它。

u1

u1.Reserved

保留。 此成员必须设置为 NULL。

ObjectUuid

远程对象的 UUID。 此 UUID 的语义与字符串绑定的语义相同。 创建绑定句柄后，调用 RpcBindingSetObject 以根据需要更改 UUID。

注解

快速绑定句柄与“经典”绑定句柄在调用 RpcBindingReset 期间处理它们的方式略有不同。 RpcBindingReset 是静态快速绑定句柄的无操作调用。 但是，对于经典绑定句柄， RpcBindingReset 会将静态绑定句柄转换为动态绑定句柄，以保持向后兼容性。

下表演示了与 RpcBindingReset 和 RpcEpResolveBinding 相关的静态和动态绑定句柄的行为。

终结点类型 Static 动态
绑定句柄类型 快速 经典 快速 经典
RpcBindingReset No-op 转换为动态 删除已解析的终结点（如果存在） 删除已解析的终结点（如果存在）
RpcEpResolveBinding No-op No-op 如果以前未解析，则解析终结点 如果以前未解析，则解析终结点

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 rpcdce.h (包括 Rpc.h)

另请参阅

RPC_BINDING_HANDLE

RpcBindingBind

RpcBindingCreate