Funzione BCryptEnumAlgorithms (bcrypt.h)

  • Articolo

La funzione BCryptEnumAlgorithms ottiene un elenco degli identificatori di algoritmo registrati.

Sintassi

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

Parametri

[in] dwAlgOperations

Valore che specifica i tipi di operazione dell'algoritmo da includere nell'enumerazione . Può trattarsi di una combinazione di uno o più dei valori seguenti.

Valore Significato
BCRYPT_CIPHER_OPERATION
0x00000001
 Includere gli algoritmi di crittografia nell'enumerazione .
BCRYPT_HASH_OPERATION
0x00000002
 Includere gli algoritmi hash nell'enumerazione .
BCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION
0x00000004
 Includere gli algoritmi di crittografia asimmetrica nell'enumerazione .
BCRYPT_SECRET_AGREEMENT_OPERATION
0x00000008
 Includere gli algoritmi del contratto segreto nell'enumerazione .
BCRYPT_SIGNATURE_OPERATION
0x00000010
 Includere gli algoritmi di firma nell'enumerazione .
BCRYPT_RNG_OPERATION
0x00000020
 Includere gli algoritmi RNG (Random Number Generator) nell'enumerazione .

[out] pAlgCount

Puntatore a una variabile ULONG per ricevere il numero di elementi nella matrice ppAlgList .

[out] ppAlgList

Indirizzo di un puntatore della struttura BCRYPT_ALGORITHM_IDENTIFIER per ricevere la matrice di identificatori di algoritmo registrati. Questo puntatore deve essere passato alla funzione BCryptFreeBuffer quando non è più necessario.

[in] dwFlags

Set di flag che modificano il comportamento di questa funzione. Non sono definiti flag per questa funzione.

Valore restituito

Restituisce un codice di stato che indica l'esito positivo o negativo della funzione.

I codici restituiti possibili includono, a titolo esemplificativo, quanto segue.

Codice restituito Descrizione
STATUS_SUCCESS
 La funzione ha avuto esito positivo.
STATUS_INVALID_PARAMETER
 Uno o più parametri non sono validi.
STATUS_NO_MEMORY
 Si è verificato un errore di allocazione della memoria.

Commenti

BCryptEnumAlgorithms può essere chiamato dalla modalità utente o dalla modalità kernel. I chiamanti in modalità kernel devono essere in esecuzione in PASSIVE_LEVELIRQL.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione bcrypt.h
Libreria Bcrypt.lib
DLL Bcrypt.dll