Функция FreeCredentialsHandle (sspi.h)
Функция FreeCredentialsHandle уведомляет систему безопасности о том, что учетные данные больше не нужны. Приложение вызывает эту функцию, чтобы освободить дескриптор учетных данных, полученный при вызове функции AcquireCredentialsHandle (General) после вызова функции DeleteSecurityContext , чтобы освободить все дескрипторы контекста, связанные с учетными данными. После удаления всех ссылок на этот набор учетных данных можно удалить сами учетные данные.
Сбой при освобождении дескрипторов учетных данных приведет к утечке памяти.
Синтаксис
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
[in] PCredHandle phCredential
);
Параметры
[in] phCredential
Указатель на дескриптор CredHandle, полученный с помощью функции AcquireCredentialsHandle (General).
Возвращаемое значение
Если функция выполняется успешно, функция возвращает SEC_E_OK.
Если функция завершается сбоем, она возвращает следующий код ошибки.
| Код возврата | Описание |
|---|---|
|
Дескриптор, переданный функции, недопустим. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | sspi.h (включая Security.h) |
| Библиотека | Secur32.lib |
| DLL | Secur32.dll |