Функция BCryptImportKeyPair (bcrypt.h)
Функция BCryptImportKeyPair
Синтаксис
NTSTATUS BCryptImportKeyPair(
[in] BCRYPT_ALG_HANDLE hAlgorithm,
[in, out] BCRYPT_KEY_HANDLE hImportKey,
[in] LPCWSTR pszBlobType,
[out] BCRYPT_KEY_HANDLE *phKey,
[in] PUCHAR pbInput,
[in] ULONG cbInput,
[in] ULONG dwFlags
);
Параметры
[in] hAlgorithm
Дескриптор поставщика алгоритма для импорта ключа. Этот дескриптор получается путем вызова функции BCryptOpenAlgorithmProvider.
[in, out] hImportKey
Этот параметр в настоящее время не используется и должен быть NULL.
[in] pszBlobType
Строка Юникода, завершающая значение NULL, содержащая идентификатор, указывающий тип БОЛЬШОго двоичного объекта, содержащегося в буфере pbInput. Это может быть одно из следующих значений.
| Ценность | Значение |
|---|---|
|
BLOB - это пара открытых и закрытых ключей Diffie-Hellman. Буфер pbInput должен содержать структуру BCRYPT_DH_KEY_BLOB сразу после ключевых данных. |
|
BLOB - это Diffie-Hellman открытый ключ BLOB. Буфер pbInput должен содержать структуру BCRYPT_DH_KEY_BLOB сразу после ключевых данных. |
|
BLOB — это пара открытых и закрытых ключей DSA. Буфер Windows 8: начинается поддержка для BCRYPT_DSA_KEY_BLOB_V2. |
|
БОЛЬШОЙ ДВОИЧНЫй объект — это BLOB-объект открытого ключа DSA. Буфер Windows 8: начинается поддержка для BCRYPT_DSA_KEY_BLOB_V2. |
|
BLOB — это многоточие криптографии (ECC) закрытого ключа. Буфер pbInput должен содержать структуру BCRYPT_ECCKEY_BLOB сразу после ключевых данных. |
|
BLOB является открытым ключом ECC. Буфер pbInput должен содержать структуру BCRYPT_ECCKEY_BLOB сразу после ключевых данных. |
|
BLOB — это универсальный открытый ключ любого типа. Тип ключа в этом BLOB-объекте определяется элементом Magic структуры BCRYPT_KEY_BLOB. |
|
BLOB является универсальным закрытым ключом любого типа. Закрытый ключ не обязательно содержит открытый ключ. Тип ключа в этом BLOB-объекте определяется элементом Magic структуры BCRYPT_KEY_BLOB. |
|
BLOB — это пара ОТКРЫТЫх и закрытых ключей RSA. Буфер pbInput должен содержать структуру BCRYPT_RSAKEY_BLOB сразу после ключевых данных. |
|
БОЛЬШОЙ ДВОИЧНЫй объект — это BLOB-объект открытого ключа RSA. Буфер pbInput должен содержать структуру BCRYPT_RSAKEY_BLOB сразу после ключевых данных. |
|
BLOB — это большой двоичный объект открытого ключа Diffie-Hellman, экспортируемый с помощью CryptoAPI. Поставщик примитивных объектов Майкрософт не поддерживает импорт этого типа BLOB. |
|
BlOB — это устаревшая Diffie-Hellman версии 3 BLOB закрытого ключа, которая содержит пару открытых и закрытых ключей Diffie-Hellman, экспортируемую с помощью CryptoAPI. |
|
BLOB — это пара BLOB-объектов открытого и закрытого ключа DSA, экспортируемая с помощью CryptoAPI. |
|
BLOB — это BLOB-объект открытого ключа DSA, экспортируемый с помощью CryptoAPI. Поставщик примитивных объектов Майкрософт не поддерживает импорт этого типа BLOB. |
|
BLOB — это закрытый ключ DSA версии 2 в форме, которую можно импортировать с помощью CryptoAPI. |
|
BLOB — это пара BLOB открытого и закрытого ключа RSA, экспортируемая с помощью CryptoAPI. |
|
BLOB - это BLOB-объект открытого ключа RSA, экспортируемый с помощью CryptoAPI. Поставщик примитивных объектов Майкрософт не поддерживает импорт этого типа BLOB. |
[out] phKey
Указатель на BCRYPT_KEY_HANDLE, получающий дескриптор импортированного ключа. Этот дескриптор используется в последующих функциях, требующих ключа, например BCryptSignHash. Этот дескриптор должен быть освобожден, если он больше не нужен, передав его в функцию BCryptDekey.
[in] pbInput
Адрес буфера, который содержит ключ BLOB- для импорта. Параметр cbInput содержит размер этого буфера. Параметр pszBlobType указывает тип ключа BLOB, который содержит этот буфер.
[in] cbInput
Размер
[in] dwFlags
Набор флагов, изменяющих поведение этой функции. Это может быть ноль или следующее значение.
| Ценность | Значение |
|---|---|
|
Не проверяйте общедоступную часть пары ключей. |
Возвращаемое значение
Возвращает код состояния, указывающий на успешность или сбой функции.
Возможные коды возврата включают в себя, но не ограничиваются следующими.
| Возвращаемый код | Описание |
|---|---|
|
Функция была успешной. |
|
Дескриптор алгоритма в параметре hAlgorithm недопустим. |
|
Один или несколько параметров недопустимы. |
|
Поставщик алгоритмов, указанный параметром hAlgorithm |
Замечания
В зависимости от того, какие режимы процессора поддерживает поставщик, BCryptImportKeyPair можно вызывать из пользовательского режима или режима ядра. Вызывающие серверы режима ядра могут выполняться в PASSIVE_LEVELIRQL или DISPATCH_LEVEL IRQL. Если текущий уровень IRQL DISPATCH_LEVEL, то дескриптор, предоставленный в параметре hAlgorithm, должен быть открыт с помощью флага BCRYPT_PROV_DISPATCH, а все указатели, переданные в функцию BCryptImportKeyPair, должны ссылаться на неупакованную (или заблокированную) память.
Чтобы вызвать эту функцию в режиме ядра, используйте Cng.lib, которая входит в состав пакета средств разработки драйверов (DDK). Windows Server 2008 и Windows Vista: для вызова этой функции в режиме ядра используйте Ksecdd.lib.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista [классические приложения | Приложения UWP] |
| минимальный поддерживаемый сервер | Windows Server 2008 [классические приложения | Приложения UWP] |
| целевая платформа | Виндоус |
| заголовка | bcrypt.h |
| библиотеки |
Bcrypt.lib |
| DLL | Bcrypt.dll |