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

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

Синтаксис

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

Параметры

[in, out] hKey

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

[in] dwFlags

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

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

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

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

Замечания

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

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

Требования

См. также

BCryptGenerateKeyPair