Funzione NCryptEnumAlgorithms (ncrypt.h)

La funzione NCryptEnumAlgorithms ottiene i nomi degli algoritmi supportati dal provider di archiviazione delle chiavi specificato.

Sintassi

SECURITY_STATUS NCryptEnumAlgorithms(
  [in]  NCRYPT_PROV_HANDLE  hProvider,
  [in]  DWORD               dwAlgOperations,
  [out] DWORD               *pdwAlgCount,
  [out] NCryptAlgorithmName **ppAlgList,
  [in]  DWORD               dwFlags
);

Parametri

[in] hProvider

Handle del provider di archiviazione delle chiavi per enumerare gli algoritmi per. Questo handle viene ottenuto con la funzione NCryptOpenStorageProvider .

[in] dwAlgOperations

Set di valori che determinano le classi di algoritmo da enumerare. Questo può essere zero o una combinazione di uno o più dei valori seguenti. Se dwAlgOperations è zero, tutti gli algoritmi vengono enumerati.

[out] pdwAlgCount

Indirizzo di un DWORD che riceve il numero di elementi nella matrice ppAlgList .

[out] ppAlgList

Indirizzo di un puntatore della struttura NCryptAlgorithmName che riceve una matrice dei nomi degli algoritmi registrati. La variabile a cui punta il parametro pdwAlgCount riceve il numero di elementi in questa matrice.

Quando questa memoria non è più necessaria, deve essere liberata passando questo puntatore alla funzione NCryptFreeBuffer .

[in] dwFlags

Contrassegni che modificano il comportamento della funzione. Questo può essere zero (0) o il valore seguente.

Valore restituito

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

I codici restituiti possibili includono, ma non sono limitati a, i seguenti.

Commenti

Un servizio non deve chiamare questa funzione dalla funzione StartService. Se un servizio chiama questa funzione dalla funzione StartService, può verificarsi un deadlock e il servizio potrebbe interrompere la risposta.

Requisiti