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

Функция BCryptFinalizeKeyPair (bcrypt.h)

  • Статья

Функция BCryptFinalizeKeyPair завершает пару открытого и закрытого ключей. Ключ нельзя использовать, пока не будет вызвана эта функция. После вызова этой функции функцию BCryptSetProperty больше нельзя использовать для этого ключа.

Синтаксис

NTSTATUS BCryptFinalizeKeyPair(
  [in, out] BCRYPT_KEY_HANDLE hKey,
  [in]      ULONG             dwFlags
);

Параметры

[in, out] hKey

Дескриптор ключа для завершения. Этот дескриптор получается путем вызова функции BCryptGenerateKeyPair .

[in] dwFlags

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

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

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

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

Код возврата Описание
STATUS_SUCCESS
 Функция выполнена успешно.
STATUS_INVALID_HANDLE
 Дескриптор ключа в параметре hKey недопустим.
STATUS_INVALID_PARAMETER
 Один или несколько параметров являются недопустимыми.
STATUS_NOT_SUPPORTED
 Указанный поставщик не поддерживает шифрование асимметричного ключа.

Комментарии

В зависимости от того, какие режимы процессора поддерживает поставщик, BCryptFinalizeKeyPair можно вызывать из пользовательского режима или режима ядра. Вызывающие функции режима ядра могут выполняться в PASSIVE_LEVELIRQL или DISPATCH_LEVEL IRQL. Если текущий уровень IRQL DISPATCH_LEVEL, дескриптор, указанный в параметре hKey , должен быть производным от дескриптора алгоритма, возвращенного поставщиком, который был открыт с флагом BCRYPT_PROV_DISPATCH .

Чтобы вызвать эту функцию в режиме ядра, используйте Cng.lib, который входит в состав пакета средств разработки драйверов (DDK). Windows Server 2008 и Windows Vista: Чтобы вызвать эту функцию в режиме ядра, используйте Ksecdd.lib.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header bcrypt.h
Библиотека Bcrypt.lib
DLL Bcrypt.dll

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

BCryptGenerateKeyPair