krb5_kt_get_name()--Get Key Table Name

Syntax

 #include <krb5.h>

 krb5_error_code krb5_kt_get_name(   
     krb5_context       context,
     krb5_keytab      ktid,
     char *       name,
     int        name_size);

  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_kt_get_name() function returns the name of the key table in the application-provided buffer supplied in the name parameter. The returned name includes the key table type prefix.

Authorities

No authorities are required.

Parameters

context (Input): The Kerberos context.
ktid (Input): The key table handle.
name (Output): The key table name.
name_size (Input): The size of the buffer pointed to by the name parameter. The size must be large enough to contain the key table name and the trailing delimiter. This may be done by allocating the buffer to be MAX_KEYTAB_NAME_LENGTH (256) +1 bytes.

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 ]