RPC_BINDING_HANDLE_TEMPLATE_V1_A結構 (rpcdce.h)
RPC_BINDING_HANDLE_TEMPLATE_V1 結構包含用來建立 RPC 系結句柄的基本選項。
語法
typedef struct _RPC_BINDING_HANDLE_TEMPLATE_V1_A {
unsigned long Version;
unsigned long Flags;
unsigned long ProtocolSequence;
unsigned char *NetworkAddress;
unsigned char *StringEndpoint;
union {
unsigned char *Reserved;
} u1;
UUID ObjectUuid;
} RPC_BINDING_HANDLE_TEMPLATE_V1_A, *PRPC_BINDING_HANDLE_TEMPLATE_V1_A;
成員
Version
這個結構的版本。 對於 RPC_BINDING_HANDLE_TEMPLATE_V1 ,這必須設定為1。
Flags
旗標值,描述 RPC 範本的特定屬性。
值 | 意義 |
---|---|
|
ObjectUuid 成員包含有效的值。 如果未設定此旗標,則 ObjectUuid 成員不包含有效的 UUID。 |
ProtocolSequence
與此系結句柄相關聯的通訊協定序列標識符。 它可以是下列值之一。
- RPC_PROTSEQ_LRPC - 指定本機 RPC。
- RPC_PROTSEQ_TCP - 指定透過 TCP/IP 的 RPC。
- RPC_PROTSEQ_NMP - 透過命名管道指定 RPC。
- RPC_PROTSEQ_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) |