Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Generic Security Services API Library Functionsgss_release_cred(3GSS)


NAME

 gss_release_cred - discard a credential handle

SYNOPSIS

 
cc -flag ...  file ...-lgss [library ...] 
#include <gssapi/gssapi.h>
OM_uint32 gss_release_cred(OM_uint32 *minor_status, gss_cred_id_t *cred_handle);

DESCRIPTION

 

The gss_release_cred() function informs the GSS-API that the specified credential handle is no longer required by the application and frees the associated resources. The cred_handle parameter is set to GSS_C_NO_CREDENTIAL when this call completes successfully.

PARAMETERS

 

The parameter descriptions for gss_release_cred() follow:

minor_status
A mechanism specific status code.
cred_handle
An opaque handle that identifies the credential to be released. If GSS_C_NO_CREDENTIAL is specified, the gss_release_cred() function will complete successfully, but it will do nothing.

RETURN VALUES

 

gss_release_cred() may return the following status codes:

GSS_S_COMPLETE
Successful completion.
GSS_S_NO_CRED
The referenced credentials cannot be accessed.
GSS_S_FAILURE
The underlying mechanism detected an error for which no specific GSS status code is defined. The mechanism-specific status code reported by means of the minor_status parameter details the error condition.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWgss (32-bit)
 SUNWgssx (64-bit)
MT-LevelSafe

SEE ALSO

 

attributes(5)

GSS-API Programming Guide


SunOS 5.9Go To TopLast Changed 24 Apr 2000

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.