HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 6 KRB5 (Kerberos V5) Application Programming Interface

krb5_cc_initialize — Create/refresh a credentials cache

  Table of Contents

  Glossary

  Index

C Prototype

krb5_error_code krb5_cc_initialize(
krb5_context context,
krb5_ccache id,
krb5_principal primary_principal );

Arguments

context (input/output) 

The context structure.

id (input/output)  

A credentials cache identifier.

primary_principal (input) 

The primary principal for the credentials cache.

Description

This routine creates or refreshes a credentials cache identified by id with the primary principal set to primary_principal. If the credentials cache already exists, its contents are destroyed.

This routine also modifies cache identified by id.

Return Values

This routine returns one of the following KRB5 status codes:

System errors. 

Permission errors.