krb5_cc_resolve()--Resolve Credentials Cache Name


  Syntax 
 #include <krb5.h>

 krb5_error_code krb5_cc_resolve(
     krb5_context     context,  
     char *       cache_name,  
     krb5_ccache *      ccache);
  Service Program Name: QSYS/QKRBGSS  
  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_cc_resolve() function resolves a credentials 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.

cache_name  (Input)
The credentials cache name in the format "type:name". The type must be a registered credentials cache type and the name must uniquely identify a particular credentials cache of the specified type.

ccache  (Output)
The credentials cache handle. The krb5_cc_close() or krb5_cc_destroy() routine should be called to release the handle 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.


Usage Notes

  1. The Kerberos runtime supports two credentials cache types: FILE and MEMORY. Additional credentials cache types can be registered by the application by calling the krb5_cc_register() routine. If no type is specified, the default is FILE.

API introduced: V5R1

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]