Función BCryptImportKeyPair (bcrypt.h)
La función
Sintaxis
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
);
Parámetros
[in] hAlgorithm
Identificador del proveedor de algoritmos para importar la clave. Este identificador se obtiene llamando a la función BCryptOpenAlgorithmProvider.
[in, out] hImportKey
Este parámetro no se usa actualmente y debe ser NULL.
[in] pszBlobType
Cadena Unicode terminada en null que contiene un identificador que especifica el tipo de BLOB que se encuentra en el pbInput búfer. Puede ser uno de los siguientes valores.
| Valor | Significado |
|---|---|
|
El BLOB es un blob de Diffie-Hellman par de claves pública y privada. El búfer pbInput debe contener una estructura BCRYPT_DH_KEY_BLOB inmediatamente seguida de los datos de clave. |
|
El BLOB es un blob de clave pública Diffie-Hellman . El búfer pbInput debe contener una estructura BCRYPT_DH_KEY_BLOB inmediatamente seguida de los datos de clave. |
|
El BLOB es un blob de par de claves pública y privada de DSA. El búfer pbInput de Windows 8: comienza compatibilidad con BCRYPT_DSA_KEY_BLOB_V2. |
|
El BLOB es un BLOB de clave pública DSA. El búfer pbInput de Windows 8: comienza compatibilidad con BCRYPT_DSA_KEY_BLOB_V2. |
|
El BLOB es un criptografía de curva elíptica (ECC) clave privada. El búfer de pbInput debe contener una estructura BCRYPT_ECCKEY_BLOB inmediatamente seguida de los datos de clave. |
|
El BLOB es una clave pública ECC. El búfer de pbInput debe contener una estructura BCRYPT_ECCKEY_BLOB inmediatamente seguida de los datos de clave. |
|
El BLOB es una clave pública genérica de cualquier tipo. El tipo de clave de este BLOB viene determinado por el miembro Magic de la estructura BCRYPT_KEY_BLOB. |
|
El BLOB es una clave privada genérica de cualquier tipo. La clave privada no contiene necesariamente la clave pública. El tipo de clave de este BLOB viene determinado por el miembro Magic de la estructura BCRYPT_KEY_BLOB. |
|
El BLOB es un blob de pares de claves pública y privada RSA. El búfer de pbInput debe contener una estructura BCRYPT_RSAKEY_BLOB inmediatamente seguida de los datos de clave. |
|
El BLOB es un BLOB de clave pública RSA. El búfer de pbInput debe contener una estructura BCRYPT_RSAKEY_BLOB inmediatamente seguida de los datos de clave. |
|
El BLOB es un BLOB de clave pública Diffie-Hellman que se exportó mediante CryptoAPI. El proveedor primitivo de Microsoft no admite la importación de este tipo BLOB. |
|
El BLOB es un blob de clave privada heredado Diffie-Hellman versión 3 que contiene un par de claves pública y privada Diffie-Hellman que se exportó mediante CryptoAPI. |
|
El BLOB es un blob de par de claves pública y privada de DSA que se exportó mediante CryptoAPI. |
|
El BLOB es un BLOB de clave pública DSA que se exportó mediante CryptoAPI. El proveedor primitivo de Microsoft no admite la importación de este tipo BLOB. |
|
El BLOB es una clave privada de la versión 2 de DSA en un formulario que se puede importar mediante CryptoAPI. |
|
El BLOB es un blob de pares de claves pública y privada RSA que se exportó mediante CryptoAPI. |
|
El BLOB es un BLOB de clave pública RSA que se exportó mediante CryptoAPI. El proveedor primitivo de Microsoft no admite la importación de este tipo BLOB. |
[out] phKey
Puntero a un BCRYPT_KEY_HANDLE que recibe el identificador de la clave importada. Este identificador se usa en funciones posteriores que requieren una clave, como BCryptSignHash. Este identificador debe liberarse cuando ya no sea necesario pasandolo a la función BCryptDestroyKey
[in] pbInput
Dirección de un búfer que contiene el blob de clave que se va a importar. El parámetro cbInput contiene el tamaño de este búfer. El parámetro pszBlobType especifica el tipo de blob de clave que contiene este búfer.
[in] cbInput
Tamaño, en bytes, del búfer de pbInput.
[in] dwFlags
Conjunto de marcas que modifican el comportamiento de esta función. Puede ser cero o el siguiente valor.
| Valor | Significado |
|---|---|
|
No valide la parte pública del par de claves. |
Valor devuelto
Devuelve un código de estado que indica el éxito o error de la función.
Entre los códigos de retorno posibles se incluyen, entre otros, los siguientes.
| Código devuelto | Descripción |
|---|---|
|
La función se realizó correctamente. |
|
El identificador de algoritmo del parámetro hAlgorithm no es válido. |
|
Uno o varios parámetros no son válidos. |
|
El proveedor de algoritmos especificado por el parámetro hAlgorithm no admite el tipo BLOB especificado por el parámetro pszBlobType. |
Observaciones
En función de los modos de procesador que admita un proveedor, se puede llamar a BCryptImportKeyPair desde el modo de usuario o el modo kernel. Los autores de llamadas en modo kernel se pueden ejecutar en PASSIVE_LEVELIRQL o DISPATCH_LEVEL IRQL. Si el nivel IRQL actual es DISPATCH_LEVEL, el identificador proporcionado en el parámetro hAlgorithm debe haberse abierto mediante la marca BCRYPT_PROV_DISPATCH y los punteros pasados a la función BCryptImportKeyPair deben hacer referencia a la memoria no paginada (o bloqueada).
Para llamar a esta función en modo kernel, use Cng.lib, que forma parte del Kit de desarrollo de controladores (DDK). Windows Server 2008 y Windows Vista: Para llamar a esta función en modo kernel, use Ksecdd.lib.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| servidor mínimo admitido | Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
| de la plataforma de destino de |
Windows |
| encabezado de |
bcrypt.h |
| biblioteca de |
Bcrypt.lib |
| DLL de |
Bcrypt.dll |