Função BCryptEnumAlgorithms (bcrypt.h)

Artigo
07/16/2024

A função BCryptEnumAlgorithms obtém uma lista dos identificadores de algoritmo registrados.

Sintaxe

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

Parâmetros

[in] dwAlgOperations

Um valor que especifica os tipos de operação de algoritmo a serem incluídos na enumeração. Isso pode ser uma combinação de um ou mais dos valores a seguir.

Valor	Significado
BCRYPT_CIPHER_OPERATION 0x00000001	Inclua os algoritmos de criptografia na enumeração.
BCRYPT_HASH_OPERATION 0x00000002	Inclua os algoritmos de hash na enumeração.
BCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION 0x00000004	Inclua os algoritmos de criptografia assimétrica na enumeração.
BCRYPT_SECRET_AGREEMENT_OPERATION 0x00000008	Inclua os algoritmos de contrato secreto na enumeração.
BCRYPT_SIGNATURE_OPERATION 0x00000010	Inclua os algoritmos de assinatura na enumeração.
BCRYPT_RNG_OPERATION 0x00000020	Inclua os algoritmos RNG (gerador de número aleatório) na enumeração.

[out] pAlgCount

Um ponteiro para uma variável ULONG para receber o número de elementos na matriz ppAlgList .

[out] ppAlgList

O endereço de um ponteiro de estrutura BCRYPT_ALGORITHM_IDENTIFIER para receber a matriz de identificadores de algoritmo registrados. Esse ponteiro deve ser passado para a função BCryptFreeBuffer quando ela não for mais necessária.

[in] dwFlags

Um conjunto de sinalizadores que modificam o comportamento dessa função. Nenhum sinalizador é definido para essa função.

Valor de retorno

Retorna um código de status que indica o êxito ou a falha da função.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_INVALID_PARAMETER	Um ou mais parâmetros não são válidos.
STATUS_NO_MEMORY	Ocorreu uma falha de alocação de memória.

Observações

BCryptEnumAlgorithms podem ser chamados do modo de usuário ou do modo kernel. Os chamadores do modo kernel devem estar em execução em PASSIVE_LEVELIRQL.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	bcrypt.h
biblioteca	Bcrypt.lib
de DLL	Bcrypt.dll

Compartilhar via