Función BCryptEnumAlgorithms (bcrypt.h)

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