Compartir a través de

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 siguientes valores.

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 de generador de números aleatorios (RNG) en la enumeración.
BCRYPT_KEY_DERIVATION_OPERATION
0x00000040
 Incluya los algoritmos de derivación de claves en la enumeración.

[out] pAlgCount

Puntero a una variable de ULONG para recibir el número de elementos de la matriz de 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 de BCryptFreeBuffer cuando ya no se necesite.

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

Observaciones

se puede llamar a BCryptEnumAlgorithms desde el modo de usuario o el modo kernel. Los llamadores de modo kernel deben ejecutarse en PASSIVE_LEVELIRQL.

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