krb5_svc_get_msg (return text message from Kerberos error code)

z/OS Integrated Security Services Network Authentication Service Programming

krb5_svc_get_msg (return text message from Kerberos error code)

z/OS Integrated Security Services Network Authentication Service Programming
SC23-6787-00

Purpose

Returns a printable text message corresponding to a Kerberos error code.

Format

#include <skrb/krb5.h>
krb5_error_code krb5_svc_get_msg (
    krb5_ui_4                          error_code,
    char **                            msg_text)

Parameters

Input

error_code: Specifies the Kerberos error code

Output

msg_text: Returns the character string describing the error code. The caller should free the character string returned by this parameter when it is no longer needed by calling the krb5_free_string() routine.

Usage

The krb5_svc_get_msg() routine returns a printable character string that describes the error represented by the supplied error code. This allows the application to log the error or display it to the user.

The function return value is zero if no errors occurred. Otherwise, it is a Kerberos error code.

Notices | Terms of use | Support | Contact z/OS | zFavorites