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.


Parameters

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.

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.


Usage Notes

  1. 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.

  2. After successfully calling krb5_rc_resolve(), the application should call either the krb5_rc_recover() or the krb5_rc_initialize() routine.


API introduced: V5R1
Top | Security APIs
UNIX-Type APIs | APIs by category