Función BCryptEnumAlgorithms (bcrypt.h)

  • Artículo

La función BCryptEnumAlgorithms obtiene una lista de los identificadores de algoritmo registrados.

Sintaxis

NTSTATUS BCryptEnumAlgorithms(
  [in]  ULONG                       dwAlgOperations,
  [out] ULONG                       *pAlgCount,
  [out] BCRYPT_ALGORITHM_IDENTIFIER **ppAlgList,
  [in]  ULONG                       dwFlags
);

Parámetros

[in] dwAlgOperations

Valor que especifica los tipos de operación de algoritmo que se van a incluir en la enumeración. Puede ser una combinación de uno o varios de los valores siguientes.

Valor Significado
BCRYPT_CIPHER_OPERATION
0x00000001
 Incluya los algoritmos de cifrado en la enumeración .
BCRYPT_HASH_OPERATION
0x00000002
 Incluya los algoritmos hash en la enumeración .
BCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION
0x00000004
 Incluya los algoritmos de cifrado asimétrico en la enumeración .
BCRYPT_SECRET_AGREEMENT_OPERATION
0x00000008
 Incluya los algoritmos de acuerdo secreto en la enumeración .
BCRYPT_SIGNATURE_OPERATION
0x00000010
 Incluya los algoritmos de firma en la enumeración .
BCRYPT_RNG_OPERATION
0x00000020
 Incluya los algoritmos del generador de números aleatorios (RNG) en la enumeración .

[out] pAlgCount

Puntero a una variable ULONG para recibir el número de elementos de la matriz ppAlgList .

[out] ppAlgList

Dirección de un puntero de estructura BCRYPT_ALGORITHM_IDENTIFIER para recibir la matriz de identificadores de algoritmo registrados. Este puntero debe pasarse a la función BCryptFreeBuffer cuando ya no sea necesario.

[in] dwFlags

Conjunto de marcas que modifican el comportamiento de esta función. No se definen marcas para esta función.

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_PARAMETER
 Uno o más parámetros no son válidos.
STATUS_NO_MEMORY
 Error de asignación de memoria.

Comentarios

Se puede llamar a BCryptEnumAlgorithms desde el modo de usuario o el modo kernel. Los autores de llamadas en modo kernel deben ejecutarse en PASSIVE_LEVELIRQL.

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