krb5_cc_resolve()--Resolve Credentials Cache Name

 #include <krb5.h>

 krb5_error_code krb5_cc_resolve(
     krb5_context     context,  
     char *       cache_name,  
     krb5_ccache *      ccache);  

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

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.