Función BCryptFinalizeKeyPair (bcrypt.h)

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 hay marcas definidas, 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 posibles códigos de retorno 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 más parámetros no son válidos.
STATUS_NOT_SUPPORTED	El proveedor especificado no admite el cifrado de claves asimétricas.

Comentarios

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 de 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	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	bcrypt.h
Library	Bcrypt.lib
Archivo DLL	Bcrypt.dll

Consulte también

BCryptGenerateKeyPair