NAME

rpc_mgmt_inq_dflt_protect_level- returns the default protection level for an authentication service

SYNOPSIS

#include <dce/rpc.h>

void rpc_mgmt_inq_dflt_protect_level(
	unsigned32 authn_svc,
	unsigned32 *protect_level,
	unsigned32 *status);

PARAMETERS

Input

authn_svc

Specifies the authentication service for which to return the default protection level. (See Authentication, Authorisation and Protection-level Arguments for values of this argument.)

Output

protect_level

Returns 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. (See Authentication, Authorisation and Protection-level Arguments for values of this argument.)

status

Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

rpc_s_unknown_authn_service

Unknown authentication service.

DESCRIPTION

The rpc_mgmt_inq_dflt_protect_level() routine returns the default protection level for the specified authentication service. The protect_level value returned is the same as the value implied when the application calls the rpc_binding_set_auth_info() or rpc_server_register_auth_info() routines with the same authn_svc value and the protect_level value of rpc_c_protect_level_default.

RETURN VALUE

None.

SEE ALSO

rpc_binding_inq_auth_caller()
rpc_binding_set_auth_info()
rpc_server_register_auth_info().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.