RPC_BINDING_HANDLE_TEMPLATE_V1_W structure (rpcdce.h)
The RPC_BINDING_HANDLE_TEMPLATE_V1 structure contains the basic options with which to create an RPC binding handle.
Syntax
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;
Members
Version
The version of this structure. For RPC_BINDING_HANDLE_TEMPLATE_V1 this must be set to 1.
Flags
Flag values that describe specific properties of the RPC template.
| Value | Meaning |
|---|---|
|
The ObjectUuid member contains a valid value. If this flag is not set, then the ObjectUuid member does not contain a valid UUID. |
ProtocolSequence
A protocol sequence string literal associated with this binding handle. It can be one of the following values.
ncalrpc - Specifies local RPC. ncacn_ip_tcp - Specifies RPC over TCP/IP. ncacn_np - Specifies RPC over named pipes. ncacn_http - Specifies RPC over HTTP.
NetworkAddress
Pointer to a string representation of the network address to bind to.
StringEndpoint
Pointer to a string representation of the endpoint to bind to. If a dynamic endpoint is used, set this member to NULL. After the endpoint is resolved, use RpcBindingToStringBinding to obtain it.
u1
u1.Reserved
Reserved. This member must be set to NULL.
ObjectUuid
The UUID of the remote object. The semantics for this UUID are the same as those for a string binding. After the binding handle is created, call RpcBindingSetObject to change the UUID as needed.
Remarks
Fast binding handles are slightly different from "classic" binding handles in the way they are handled during calls to RpcBindingReset. RpcBindingReset is a no-op call for static fast binding handles. For classic binding handles, however, RpcBindingReset converts a static binding handle into a dynamic one to preserve backwards compatibility.
The following table demonstrates the behavior of static and dynamic binding handles with regards to RpcBindingReset and RpcEpResolveBinding.
| Endpoint Type | Static | Dynamic | ||
|---|---|---|---|---|
| Binding Handle Type | Fast | Classic | Fast | Classic |
| RpcBindingReset | No-op | Converts to dynamic | Removes resolved endpoint if one is present | Removes resolved endpoint if one is present |
| RpcEpResolveBinding | No-op | No-op | Resolves endpoint if not previously resolved | Resolves endpoint if not previously resolved |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Header | rpcdce.h (include Rpc.h) |