Функция CryptDecryptHash (wincrypt.h)

Важно Этот API не рекомендуется использовать. Новое и существующее программное обеспечение должно начать использовать API-интерфейсы шифрования следующего поколения. Корпорация Майкрософт может удалить этот API в будущих выпусках.

 

Функция CryptDeographyHash уничтожает хэш-объект , на который ссылается параметр hHash . После уничтожения хэш-объекта его больше нельзя использовать.

Чтобы обеспечить безопасность, рекомендуется уничтожать хэш-объекты после их использования.

Синтаксис

BOOL CryptDestroyHash(
  [in] HCRYPTHASH hHash
);

Параметры

[in] hHash

Дескриптор хэш-объекта, который необходимо уничтожить.

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

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

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError.

Коды ошибок, предваряемые "NTE", создаются конкретным поставщиком служб шифрования (CSP), который вы используете. Ниже приведены некоторые возможные коды ошибок.

Код возврата	Описание
ERROR_BUSY	Хэш-объект, заданный hHash , в настоящее время используется и не может быть уничтожен.
ERROR_INVALID_HANDLE	Параметр hHash указывает недопустимый дескриптор.
ERROR_INVALID_PARAMETER	Параметр hHash содержит недопустимое значение.
NTE_BAD_ALGID	Дескриптор hHash указывает алгоритм, который не поддерживается этим поставщиком служб CSP.
NTE_BAD_HASH	Недопустимый хэш-объект, заданный параметром hHash .
NTE_BAD_UID	Не удается найти контекст CSP, указанный при создании хэш-объекта.

Комментарии

При уничтожении хэш-объекта многие поставщики служб конфигурации перезаписывают память в CSP, где был размещен хэш-объект. Затем освобождается память CSP.

Между вызовами CryptCreateHash и CryptDe соответствии должно быть соответствие "один к одному".

Все хэш-объекты, созданные с помощью определенного CSP, должны быть уничтожены, прежде чем этот дескриптор CSP будет освобожден с помощью функции CryptReleaseContext .

Примеры

Пример, в котором используется функция CryptDetraitsHash , см. в разделе Пример программы C: создание и хэширование ключа сеанса.

Требования

Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wincrypt.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll

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

CryptCreateHash

CryptHashData

CryptSignHash

Хэш-функции и функции цифровой подписи