krb5_svc_get_msg()--Get Printable Text Message Corresponding to Kerberos Error Code


  Syntax
 #include <krb5.h>

 krb5_error_code krb5_svc_get_msg(  
     krb5_ui_4        error_code,  
     char **        msg_text); 
  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_svc_get_msg() function returns a printable text message corresponding to a Kerberos error code. This allows the application to log the error or display it to the user.


Authorities

No authorities are required.


Parameters

error_code  (Input)
The Kerberos error code.

msg_text  (Output)
The character string describing the error code. The krb5_free_string() routine should be called to release the character string 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 ]