Función BCryptDeriveKeyPBKDF2 (bcrypt.h)

  • Artículo

La función BCryptDeriveKeyPBKDF2 deriva una clave de un valor hash mediante el algoritmo de derivación de claves PBKDF2 tal y como se define en RFC 2898.

Sintaxis

NTSTATUS BCryptDeriveKeyPBKDF2(
  [in]           BCRYPT_ALG_HANDLE hPrf,
  [in, optional] PUCHAR            pbPassword,
  [in]           ULONG             cbPassword,
  [in, optional] PUCHAR            pbSalt,
  [in]           ULONG             cbSalt,
  [in]           ULONGLONG         cIterations,
  [out]          PUCHAR            pbDerivedKey,
  [in]           ULONG             cbDerivedKey,
  [in]           ULONG             dwFlags
);

Parámetros

[in] hPrf

Identificador de un proveedor de algoritmos que proporciona la función pseudoaleatoriedad. Debe ser un proveedor de algoritmos que realice un cálculo de código de autenticación de mensajes. Cuando se usa el proveedor de algoritmos predeterminado de Microsoft, se puede usar cualquier algoritmo hash abierto mediante la marca BCRYPT_ALG_HANDLE_HMAC_FLAG .

Nota Solo se pueden usar algoritmos que implementan la propiedad BCRYPT_IS_KEYED_HASH para rellenar este parámetro.
 

[in, optional] pbPassword

Puntero a un búfer que contiene el parámetro de contraseña para el algoritmo de derivación de claves PBKDF2.

Nota Cualquier información secreta usada en la derivación de claves debe pasarse en este búfer.

 

[in] cbPassword

Longitud, en bytes, de los datos del búfer al que apunta el parámetro pbPassword .

[in, optional] pbSalt

Puntero a un búfer que contiene el argumento salt para el algoritmo de derivación de claves PBKDF2.

Nota Cualquier información que no sea secreta y que se use en la derivación de claves debe pasarse en este búfer.
 

[in] cbSalt

Longitud, en bytes, del argumento salt al que apunta el parámetro pbSalt .

[in] cIterations

Recuento de iteraciones para el algoritmo de derivación de claves PBKDF2.

[out] pbDerivedKey

Puntero a un búfer que recibe la clave derivada.

[in] cbDerivedKey

Longitud, en bytes, de la clave derivada devuelta en el búfer a la que apunta el parámetro pbDerivedKey .

[in] dwFlags

Este parámetro está reservado y debe establecerse en 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 del parámetro hPrf no es válido.
STATUS_INVALID_PARAMETER
 Uno o más parámetros no son válidos.
STATUS_NO_MEMORY
 Error de asignación de memoria.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado bcrypt.h
Library Bcrypt.lib
Archivo DLL Bcrypt.dll