RPC_BINDING_HANDLE_TEMPLATE_V1_W 結構 (rpcdce.h)

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 - 指定透過 HTTP 的 RPC。

NetworkAddress

要系結之網路位址之字串表示的指標。

StringEndpoint

要系結之端點之字串表示的指標。 如果使用動態端點，請將此成員設定為 NULL。 解析端點之後，請使用 RpcBindingToStringBinding 來取得它。

u1

u1.Reserved

保留的。 這個成員必須設定為 NULL。

ObjectUuid

遠端物件的 UUID。 此 UUID 的語意與字串系結的語意相同。 建立系結句柄之後，請呼叫 RpcBindingSetObject ，視需要變更 UUID。

備註

快速系結句柄與「傳統」系結句柄稍有不同，方法是在 呼叫 RpcBindingReset 期間處理它們。 RpcBindingReset 是靜態快速系結句柄的無作業呼叫。 不過，對於傳統系結句柄， RpcBindingReset 會將靜態系結句柄轉換成動態系結句柄，以保留回溯相容性。

下表示范有關 RpcBindingReset 和 RpcEpResolveBinding 的靜態和動態系結句柄行為。

端點類型	靜態		動態
系結句柄類型	快速	傳統	快速	傳統
RpcBindingReset	No-op	轉換成動態	如果存在已解析的端點，則會移除已解析的端點	如果存在已解析的端點，則會移除已解析的端點
RpcEpResolveBinding	No-op	No-op	如果先前未解析，則解析端點	如果先前未解析，則解析端點

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	rpcdce.h (包含 Rpc.h)

另請參閱

RPC_BINDING_HANDLE

RpcBindingBind

RpcBindingCreate