# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_mk_req - Create a KRB_AP_REQ message.

krb5_error_code `krb5_mk_req`(krb5_context context, krb5_auth_context * auth_context, krb5_flags ap_req_options, const char * service, const char * hostname, krb5_data * in_data, krb5_ccache ccache, krb5_data * outbuf)

param: | [in] context - Library context [inout] auth_context - Pre-existing or newly created auth context [in] ap_req_options - `AP_OPTS` options [in] service - Service name, or NULL to use “host” [in] hostname - Host name, or NULL to use local hostname [in] in_data - Application data to be checksummed in the authenticator, or NULL [in] ccache - Credential cache used to obtain credentials for the desired service. [out] outbuf - AP-REQ message

retval: | 0 Success; otherwise - Kerberos error codes

This function is similar to `krb5_mk_req_extended()` except that it uses a given hostname , service , and ccache to construct a service principal name and obtain credentials.

Use `krb5_free_data_contents()` to free outbuf when it is no longer needed.