Funzione NCryptEnumStorageProviders (ncrypt.h)

Articolo
02/29/2024

La funzione NCryptEnumStorageProviders ottiene i nomi dei provider di archiviazione delle chiavi registrati.

Sintassi

SECURITY_STATUS NCryptEnumStorageProviders(
  [out] DWORD              *pdwProviderCount,
  [out] NCryptProviderName **ppProviderList,
  [in]  DWORD              dwFlags
);

Parametri

[out] pdwProviderCount

Indirizzo di un DWORD per ricevere il numero di elementi nella matrice ppProviderList .

[out] ppProviderList

Indirizzo di un puntatore alla struttura NCryptProviderName per ricevere una matrice dei nomi dei provider di archiviazione chiavi registrati. La variabile a cui punta il parametro pdwProviderCount riceve il numero di elementi in questa matrice.

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

[in] dwFlags

Flag che modificano il comportamento della funzione. Può essere zero (0) o il valore seguente.

Valore	Significato
NCRYPT_SILENT_FLAG	Richiede che il provider di servizi chiave (KSP) non visualizzi alcuna interfaccia utente. Se il provider deve visualizzare l'interfaccia utente per il funzionamento, la chiamata ha esito negativo e il provider di servizi di configurazione deve impostare il codice di errore NTE_SILENT_CONTEXT come ultimo errore.

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
ERROR_SUCCESS	La funzione ha avuto esito positivo.
NTE_BAD_FLAGS	Il parametro dwFlags contiene un valore non valido.
NTE_INVALID_PARAMETER	Uno o più parametri non sono validi.
NTE_NO_MEMORY	Si è verificato un errore di allocazione della memoria.

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 smettere di rispondere.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ncrypt.h
Libreria	Ncrypt.lib
DLL	Ncrypt.dll

Vedi anche

NCryptFreeBuffer

Condividi tramite