Поделиться через


Функция FreeCredentialsHandle (sspi.h)

Функция FreeCredentialsHandle уведомляет систему безопасности о том, что учетные данные больше не нужны. Приложение вызывает эту функцию, чтобы освободить дескриптор учетных данных, полученный при вызове функции AcquireCredentialsHandle (General) после вызова функции DeleteSecurityContext , чтобы освободить все дескрипторы контекста, связанные с учетными данными. После удаления всех ссылок на этот набор учетных данных можно удалить сами учетные данные.

Сбой при освобождении дескрипторов учетных данных приведет к утечке памяти.

Синтаксис

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
  [in] PCredHandle phCredential
);

Параметры

[in] phCredential

Указатель на дескриптор CredHandle, полученный с помощью функции AcquireCredentialsHandle (General).

Возвращаемое значение

Если функция выполняется успешно, функция возвращает SEC_E_OK.

Если функция завершается сбоем, она возвращает следующий код ошибки.

Код возврата Описание
SEC_E_INVALID_HANDLE
Дескриптор, переданный функции, недопустим.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header sspi.h (включая Security.h)
Библиотека Secur32.lib
DLL Secur32.dll

См. также раздел

AcquireCredentialsHandle (общие)

Функции SSPI