Compartir a través de

Función BCryptFinalizeKeyPair (bcrypt.h)

  • Artículo

La función BCryptFinalizeKeyPair completa un par de claves pública y privada . No se puede usar la clave hasta que se haya llamado a esta función. Después de llamar a esta función, la función BCryptSetProperty ya no se puede usar para esta clave.

Sintaxis

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

Parámetros

[in, out] hKey

Identificador de la clave que se va a completar. Este identificador se obtiene llamando a la función BCryptGenerateKeyPair.

[in] dwFlags

Conjunto de marcas que modifican el comportamiento de esta función. Actualmente no se definen marcas, por lo que este parámetro debe ser cero.

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
STATUS_SUCCESS
 La función se realizó correctamente.
STATUS_INVALID_HANDLE
 El identificador de clave del parámetro hKey no es válido.
STATUS_INVALID_PARAMETER
 Uno o varios parámetros no son válidos.
STATUS_NOT_SUPPORTED
 El proveedor especificado no admite el cifrado de claves asimétricas.

Observaciones

En función de los modos de procesador que admita un proveedor, se puede llamar a BCryptFinalizeKeyPair 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 hKey debe derivarse de un identificador de algoritmo devuelto por un proveedor que se abrió con la marca BCRYPT_PROV_DISPATCH.

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

Consulte también

BCryptGenerateKeyPair