Share via


FreeCredentialsHandle

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Smartphone 2002 and later

See Also

Reference

AcquireCredentialsHandle