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

krb5_cc_destroy — Destroy a credentials cache

  Table of Contents

  Glossary

  Index

C Prototype

krb5_error_code krb5_cc_destroy(
krb5_context context,
krb5_ccache id );

Arguments

context (input/output) 

The context structure.

id (input/output)  

A credentials cache identifier.

Description

This routine destroys the credentials cache identified by id, invalidates id, and releases any other resources acquired during use of the credentials cache. This routine requires that id identifies a valid credentials cache. After return, id must not be used unless it is first reinitialized using krb5_cc_resolve or krb5_cc_gen_new.

Return Values

This routine returns the following KRB5 status code:

Permission errors.