NAME

rpc_mgmt_inq_dflt_protect_level - Returns the default protection level for an authentication service

Used by client and server applications. 

SYNOPSIS

#include <dce/rpc.h>
void rpc_mgmt_inq_dflt_protect_level(

unsigned32 authn_svc ,
unsigned32 ∗protect_level ,
unsigned32 ∗status );

PARAMETERS

Input

authn_svcSpecifies the authentication service for which to return the default protection level.  The supported authentication services are

rpc_c_authn_noneNo authentication

rpc_c_authn_dce_secretDCE shared-secret key authentication

rpc_c_authn_dce_publicDCE public key authentication (reserved for future use)

rpc_c_authn_defaultDCE default authentication service

Output

protect_levelReturns the default protection level for the specified authentication service.  The protection level determines the degree to which authenticated communications between the client and the server are protected.  The possible protection levels are

rpc_c_protect_level_default
Use the default protection level for the specified authentication service.

rpc_c_protect_level_nonePerform no protection. 

rpc_c_protect_level_connect
Perform protection only when the client establishes a relationship with the server.

rpc_c_protect_level_callPerform protection only at the beginning of each remote procedure call when the server receives the request. 

rpc_c_protect_level_pktEnsure that all data received is from the expected client. 

rpc_c_protect_level_pkt_integrity
Ensure and verify that none of the data transferred between client and server has been modified.

rpc_c_protect_level_pkt_privacy
Perform protection as specified by all of the previous levels and also encrypt each remote procedure call argument value.

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not.  The possible status codes and their meanings are as follows:

rpc_s_okSuccess. 

rpc_s_unknown_auth_service
Unknown authentication service.

DESCRIPTION

The rpc_mgmt_inq_dflt_protect_level routine returns the default protection level for the specified authentication service. 

A client can call this routine to learn the default protection level before specifying rpc_c_protect_level_default for the protect_level parameter in the rpc_binding_set_auth_info or rpc_ss_register_auth_info routine.  If the default level is inappropriate, the client can specify a different, explicit level. 

A called remote procedure within a server application can call this routine to obtain the default protection level for a given authentication service.  By calling routine rpc_binding_inq_auth_client in the remote procedure, the server can obtain the protection level set up by the calling client.  The server can then compare the client-specified protection level with the default level to determine whether to allow the remote procedure to execute. 

Alternatively, a remote procedure can compare the client’s protection level against a level other than the default level.  In this case there is no need for the server’s remote procedure to call this routine. 

NOTES

For this release, the RPC authentication (RPC auth) routines are not implemented, nor is an independent security service provided. 

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_binding_inq_auth_client(3), rpc_binding_set_auth_info(3), rpc_ss_register_auth_info(3)