NAME

sec_login_tkt_request_options-

SYNOPSIS

#include <dce/sec_login.h>

void sec_login_tkt_request_options (
    sec_login_handle_t  login_context,
    sec_login_tkt_info_t *tkt_info,
    error_status_t *status );

PARAMETERS

Input

login_context

A login context handle in the setup or refreshed state. The requested data is placed in the KRB_REQUEST_INFO portion of the login context upon successful completion of this function.

tkt_info

(Pointer to) a structure which specifies the types of ticket options requested. If a renewable or postdated ticket is requested, or if a non-default ticket lifetime is requested, additional data must be provided in the respective field associated with the option. These fields are the renewable_lifetime, postdated_dormanttime, or lifetime fields of the sec_login_tkt_info_t structure, respectively.

Output

status

The completion status.

AS ticket options

The requested options as specified in the options and option-associated fields, respectively, of the sec_login_tkt_info_t structure.

DESCRIPTION

This function is used by a client to request specific AS ticket options. This optional function should be called after sec_login_setup_identity() or sec_login_refresh_identity() and before sec_login_validate_identity() or sec_login_valid_and_cert_ident().

Input should consist of a login context handle in the setup or refreshed state, and a structure which specifies the types of ticket options requested. If the user requests a renewable/postdated ticket, or a non-default ticket lifetime, additional data must be provided in the renewable_lifetime, postdated_dormanttime, and lifetime fields of the sec_login_tkt_info_t structure, respectively.

The data is placed in the KRB_REQUEST_INFO portion of the login context. These options will override the defaults when the ticket is requested at validation time.

FILES

/usr/include/dce/sec_login.idl

The idl file from which dce/sec_login.h was derived.

ERRORS

error_status_ok

SEE ALSO

Functions: sec_login_refresh_identity(), sec_login_setup_identity(), sec_login_validate_identity(), sec_login_valid_and_cert_ident().