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
- 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 ]