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 Binding42F3.CT for a description of the registry settings that are affected by the RPC_POLICY flags.

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

Configuring the Windows NT Registry for Port Allocations and Selective Binding, RpcServerUseAllProtseqsEx, RpcServerUseAllProtseqsIfEx, RpcServerUseProtseqEx, RpcServerUseProtseqEpEx, RpcServerUseProtseqIfEx