RPC_POLICY
typedef struct _RPC_POLICY {
unsigned
int Length;
unsigned
long EndpointFlags;
unsigned long NICFlags;
}
RPC_POLICY, __RPC_FAR * PRPC_POLICY;
Length
Specifies the
size, in bytes, of the RPC_POLICY structure.
EndpointFlags
Specifies
Internet or intranet (local network) ports for endpoint assignments.
NICFlags
Controls
binding to network interface cards (NICs).
Remarks
The
RPC_Policy structure contains flags that allow you to restrict port allocation
for dynamic ports and that allow multihomed machines to selectively bind to
Network Interface Cards (NICs). The values in this structure are ignored if the
client and server are using a protocol other than tcp/ip (protocol sequence ncacn_ip_tcp).
See Configuring the Windows NT Registry for Port Allocations and Selective
Binding
The Length
member allows compatibility with future versions of this structure, which may
contain additional fields. Set Length = sizeof(RPC_POLICY) when initializing
the RPC_POLICY structure in your code.
The EndpointFlags
member controls endpoint assignments. Allowable values for this field are:
0 |
(Specifies
the system default) |
1 |
RPC_C_USE_INTERNET_PORT |
2 |
RPC_C_USE_INTRANET_PORT |
Note If the
registry does not contain any of the keys that specify the default policy for
port allocation, then the EndpointFlags member will have no effect at
run time. If a key is missing or contains an invalid value, then the entire
configuration is marked as invalid and all RpcServerUseProtseq(ncacn_ip_tcp)
calls will fail.
The NICFlags
member tells RPC to either bind to NICs based on the settings in the registry,
or to override the registry settings and bind to all NICs. Allowable values for
this field are:
0 |
Bind to
NICs on the basis of the registry settings |
1 |
RPC_C_BIND_TO_ALL_NICS |
Note If the Bind
key is missing from the registry, then the NICFlags member will have no
effect at run time. If the key contains an invalid value, then the entire
configuration is marked as invalid and all RpcServerUseProtseq*(ncacn_ip_tcp)
calls will fail.
See Also