FreeCredentialsHandle

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.

At a Glance

Header file: Sspi.h
Windows CE versions: 2.10 and later

Syntax

SECURITY_STATUS FreeCredentialsHandle( PCredHandle phCredential);

Parameters

phCredential

Pointer to the credential handle obtained by using the AcquireCredentialsHandle function

Return Values

SEC_E_OK indicates success. Upon failure, SEC_E_INVALID_HANDLE indicates that the handle passed to the function is invalid.

Remarks

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

See Also

AcquireCredentialsHandle