Funzione BCryptEnumAlgorithms (bcrypt.h)

Articolo
11/18/2024

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 .
BCRYPT_KEY_DERIVATION_OPERATION 0x00000040	Includere gli algoritmi di derivazione della chiave nell'enumerazione .

[out] pAlgCount

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

[out] ppAlgList

Indirizzo di un puntatore di 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, ma non solo, 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.

Osservazioni

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [app desktop \| App UWP]
server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	bcrypt.h
libreria	Bcrypt.lib
dll	Bcrypt.dll

Condividi tramite