krb5_mk_error()--Create Kerberos KRB_ERROR Message

 #include <krb5.h>

 krb5_error_code krb5_mk_error(
     krb5_context       context,
     krb5_const krb5_error *    dec_err,   
     krb5_data *      enc_err);   

The krb5_mk_error() function creates a Kerberos KRB_ERROR message. This message is then sent to the remote partner instead of sending a reply message. For example, if an error is detected while processing an AP_REQ message, the application returns a KRB_ERROR message instead of an AP_REP message.

Authorities

No authorities are required.

Parameters

context  (Input)

The Kerberos context.

dec_err  (Input)

The krb5_error structure to be encoded.

enc_err  (Output)

The encoded krb5_error structure as a byte stream. The krb5_free_data_contents() routine should be called to release the storage pointed to by the data field of the krb5_data structure when it is no longer needed.

Return Value

If no errors occur, the return value is 0. Otherwise, a Kerberos error code is returned.

Error Messages

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]