Funzione BCryptEnumProviders (bcrypt.h)

Articolo
07/16/2024

La funzione BCryptEnumProviders ottiene tutti i provider CNG che supportano un algoritmo specificato.

Sintassi

NTSTATUS BCryptEnumProviders(
  [in]  LPCWSTR              pszAlgId,
  [out] ULONG                *pImplCount,
  [out] BCRYPT_PROVIDER_NAME **ppImplList,
  [in]  ULONG                dwFlags
);

Parametri

[in] pszAlgId

Puntatore a una stringa Unicode con terminazione Null che identifica l'algoritmo per cui ottenere i provider. Può trattarsi di uno degli identificatori di algoritmo CNG predefiniti o un altro identificatore di algoritmo.

[out] pImplCount

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

[out] ppImplList

Indirizzo di una matrice di strutture BCRYPT_PROVIDER_NAME per ricevere la raccolta di provider che supportano l'algoritmo specificato. Il parametro pImplCount riceve il numero di elementi in questa matrice. Questa memoria deve essere liberata quando non è più necessaria passando questo puntatore alla funzione BCryptFreeBuffer.

[in] dwFlags

Set di flag che modifica il comportamento di questa funzione. Attualmente non sono definiti flag, quindi questo parametro deve essere zero.

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

BCryptEnumProviders 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

Vedere anche

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer

Condividi tramite