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

Функция NCryptVerifySignature (ncrypt.h)

Функция NCryptVerifySignature проверяет, соответствует ли указанная сигнатура указанному хэшу.

Синтаксис

SECURITY_STATUS NCryptVerifySignature(
  [in]           NCRYPT_KEY_HANDLE hKey,
  [in, optional] VOID              *pPaddingInfo,
  [in]           PBYTE             pbHashValue,
  [in]           DWORD             cbHashValue,
  [in]           PBYTE             pbSignature,
  [in]           DWORD             cbSignature,
  [in]           DWORD             dwFlags
);

Параметры

[in] hKey

Дескриптор ключа, используемый для расшифровки подписи. Это должен быть идентичный ключ или часть открытого ключа пары ключей, используемая для подписывания данных с помощью функции NCryptSignHash .

[in, optional] pPaddingInfo

Указатель на структуру, содержащую сведения о заполнении. Фактический тип структуры, указываемой этим параметром, зависит от значения параметра dwFlags . Этот параметр используется только с асимметричными ключами и должен быть NULL в противном случае.

[in] pbHashValue

Адрес буфера, содержащего хэш данных. Параметр cbHash содержит размер этого буфера.

[in] cbHashValue

Размер в байтах буфера pbHash .

[in] pbSignature

Адрес буфера, содержащего подписанный хэш данных. Функция NCryptSignHash используется для создания сигнатуры. Параметр cbSignature содержит размер этого буфера.

[in] cbSignature

Размер в байтах буфера pbSignature . Функция NCryptSignHash используется для создания сигнатуры.

[in] dwFlags

Флаги, изменяющие поведение функции. Допустимый набор флагов зависит от типа ключа, указанного параметром hKey .

Если ключ является симметричным ключом, этот параметр не используется и должен быть нулевым.

Если ключ является асимметричным ключом, это может быть одно из следующих значений:

Ценность Значение
NCRYPT_PAD_PKCS1_FLAG Схема заполнения PKCS1 использовалась при создании сигнатуры. Параметр pPaddingInfo — это указатель на структуру BCRYPT_PKCS1_PADDING_INFO .
BCRYPT_PAD_PQDSA Используйте схему заполнения PQ для ML-DSA или SLH-DSA. Параметр pPaddingInfo — это указатель на структуру BCRYPT_PQDSA_PADDING_INFO .

Заметка: Это необходимо задать, если используется предварительно хэш-ML-DSA вариант.
NCRYPT_PAD_PSS_FLAG Схема вероятностной подписи (PSS) использовалась при создании подписи. Параметр pPaddingInfo — это указатель на структуру BCRYPT_PSS_PADDING_INFO .
NCRYPT_SILENT_FLAG Запрашивает, что поставщик ключевых служб (KSP) не отображает пользовательский интерфейс. Если поставщик должен отобразить пользовательский интерфейс для работы, вызов завершается ошибкой, и KSP должен задать код ошибки NTE_SILENT_CONTEXT в качестве последней ошибки.

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

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

Возможные коды возврата включают, но не ограничиваются следующими:

Код возврата Описание
ERROR_SUCCESS Функция была успешной.
NTE_BAD_SIGNATURE Подпись не была проверена.
NTE_INVALID_HANDLE Недопустимый параметр hKey .
NTE_NO_MEMORY Произошел сбой выделения памяти.
NTE_NOT_SUPPORTED Поставщик алгоритмов, используемый для создания дескриптора ключа, указанного параметром hKey , не является алгоритмом подписи.

Замечания

Служба не должна вызывать эту функцию из функции StartService. Если служба вызывает эту функцию из функции StartService , может произойти взаимоблокировка, а служба может перестать отвечать.

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows Vista [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер Windows Server 2008 [классические приложения | Приложения UWP]
целевая платформа Виндоус
Заголовок ncrypt.h
Библиотека Ncrypt.lib
Библиотека dll Ncrypt.dll

См. также

NCryptSignHash

  • Last updated on