rpc_ss_bind_authn_client- authenticates a client's identity to a server from a client stub
void rpc_ss_bind_authn_client( rpc_binding_handle_t *binding, rpc_if_handle_t if_handle, error_status_t *status);
- 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.
- Specifies the server binding handle for the remote procedure call to which the routine will add authentication and authorization context.
- 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:
No further server bindings are available for modification.
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_infoand Authentication, Authorisation and Protection-level ArgumentsThe routine sets the authorization service to perform authorization based on the client's principal 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.