Share via


FreeCredentialsHandle (Compact 2013)

3/28/2014

This function notifies the security system that credentials are no longer required. An application calls this function to free the credential handle acquired in the call to the AcquireCredentialsHandle function. When all references to this credential set have been removed, the credentials themselves can be removed.

Syntax

SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle( 
  PCredHandle phCredential 
);

Parameters

  • phCredential
    [in] Pointer to a CredHandle structure representing the handle to the credentials. This handle is obtained by using the AcquireCredentialsHandle function. For information on CredHandle, see SSPI Handles.

Return Value

Returns SEC_E_OK to indicate success. The function returns SEC_E_INVALID_HANDLE upon failure, to indicate that the handle passed to the function is invalid.

Remarks

This function enables the security system to free resources associated with the credential handle.

Requirements

Header

security.h,
sspi.h

Library

secur32.lib

See Also

Reference

Authentication Services Functions
AcquireCredentialsHandle