NAME

rpc_ss_bind_authn_client- authenticates a client's identity to a server from a client stub

SYNOPSIS

#include <rpc.h>

void rpc_ss_bind_authn_client(
	rpc_binding_handle_t *binding,
	rpc_if_handle_t if_handle,
	error_status_t *status);

PARAMETERS

Input

if_handle

A stub-generated data structure that specifies the interface of interest. The routine can use this argument to resolve a partial binding or to distinguish between interfaces.

Input/Output

binding

Specifies the server binding handle for the remote procedure call to which the routine will add authentication and authorization context.

Output

status

Returns the status code from this routine. This 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_no_more_bindings

No further server bindings are available for modification.

DESCRIPTION

The rpc_ss_bind_authn_client() routine is intended for use with the binding_callout ACF interface attribute. The binding_callout attribute enables applications to specify the name of a routine that the client stub will call automatically to modify a server binding handle with additional information before it initiates a remote procedure call. (See The binding_callout Attribute .) This attribute is especially useful for applications using the automatic binding method, where it is the client stub, rather than the application code, that obtains the binding handle. The binding_callout attribute provides these applications with a way to gain access to a server binding handle from the client stub, since the handle is not accessible from the application code. for information.

Applications can specify rpc_ss_bind_authn_client() to the binding_callout ACF interface attribute in order to authenticate the client's identity to a server from the client stub before the remote procedure call to the server is initiated. This routine performs one-way authentication: the client does not care which server principal receives the remote procedure call request, but the server verifies that the client is who the client claims to be.

The routine sets the protection level used, the authentication identity, and the authentication service used to their default values. (See tagmref_rpc_binding_set_auth_info and Authentication, Authorisation and Protection-level Arguments The routine sets the authorization service to perform authorization based on the client's principal name.

RETURN VALUE

None.

SEE ALSO

rpc_binding_set_auth_info()
rpc_ep_resolve_binding()
rpc_mgmt_inq_server_princ_name().

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.