Função BCryptEnumAlgorithms (bcrypt.h)

  • Artigo

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.

Retornar valor

Retorna um código 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 dos parâmetros não são válidos.
STATUS_NO_MEMORY
 Ocorreu uma falha de alocação de memória.

Comentários

BCryptEnumAlgorithms pode ser chamado do modo de usuário ou do modo kernel. Os chamadores do modo kernel devem estar executando em PASSIVE_LEVELIRQL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho bcrypt.h
Biblioteca Bcrypt.lib
DLL Bcrypt.dll