HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 5 GSSAPI (Generic Security Services Application Programming Interface)

gss_release_cred — Mark a credential for deletion

  Table of Contents

  Glossary

  Index

C Prototype

OM_uint32 gss_release_cred(
OM_uint32 * minor_status,
gss_cred_id_t * cred_handle );

Arguments

minor_status (output) 

A mechanism-specific status code.

cred_handle (input/output) 

A buffer containing an opaque credential handle identifying the credential to be released. If GSS_C_NO_CREDENTIAL is supplied, the routine will complete successfully, but will do nothing.

Description

This routine informs GSSAPI that the specified credential handle is no longer required by the application, and frees associated resources. When all processes have released a credential, it will be deleted.

Return Values

This routine returns one of the following GSS status codes:

GSS_S_COMPLETE

Successful completion.

GSS_S_NO_CRED

The credentials could not be accessed.