krb5_rc_resolve()--Resolve Replay Cache Name

Syntax

 #include <krb5.h>

 krb5_error_code krb5_rc_resolve(
     krb5_context     context,  
     krb5_rcache *      rcache, 
     char *       name);

  Service Program Name: QSYS/QKRBGSS
  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_rc_resolve() resolves a replay cache name and returns a handle that can be used to access the cache.

Authorities

No authorities are required.

context (Input): The Kerberos context.
rcache (Output): The replay cache handle.
name (Input): The replay cache name in the format "type:name". The type must be a registered replay cache type and the name must uniquely identify a particular replay cache of the specified type.

If no errors occur, the return value is 0. Otherwise, a Kerberos error code is returned.

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

The Kerberos runtime supports two replay cache types: dfl and mem. Additional replay cache types can be registered by the application by calling the krb5_rc_register_type() routine. If no type is specified, the default is dfl.
After successfully calling krb5_rc_resolve(), the application should call either the krb5_rc_recover() or the krb5_rc_initialize() routine.

API introduced: V5R1