krb5_rd_error()--Process Kerberos KRB_ERROR Message

Syntax

 #include <krb5.h>

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

  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_rd_error() function processes a Kerberos KRB_ERROR message created by the krb5_mk_error() routine and returns a krb5_error structure.

Authorities

No authorities are required.

Parameters

context (Input): The Kerberos context.
enc_err (Input): The error message created by the krb5_mk_error() routine.
dec_err (Output): The decoded error message. The krb5_free_error() routine should be called to release the krb5_error 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

Message ID	Error Message Text
CPE3418 E	Possible APAR condition or hardware failure.

API introduced: V5R1

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