FreeCredentialsHandle
A version of this page is also available for
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 |