Compartilhar via


Função BCryptEnumAlgorithms (bcrypt.h)

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