krb5_cc_register()--Define New Credentials Cache Type

Syntax

 #include <krb5.h>

 krb5_error_code krb5_cc_register(  
     krb5_context     context,
     krb5_cc_ops *      ops,
     krb5_boolean     override);

  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_cc_register() function allows an application to define a new credentials cache type. Once the new type is registered, it can be used by any thread in the current process and activation group. The type is not known outside the current process and activation group, and is no longer registered when the application ends.

Authorities

No authorities are required.

Parameters

context (Input): The Kerberos context.
ops (Input): The credentials cache operations vector. This vector defines the routines that are called to perform the various credentials cache operations for the new cache type.
override (Input): Whether to override an existing definition for the same type. An error is returned if the type is already registered and FALSE is specified for this parameter.

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 ]