Funzione NCryptIsAlgSupported (ncrypt.h)

Articolo
08/25/2023

La funzione NCryptIsAlgSupported determina se un provider di archiviazione chiavi CNG supporta un algoritmo di crittografia specifico.

Sintassi

SECURITY_STATUS NCryptIsAlgSupported(
  [in] NCRYPT_PROV_HANDLE hProvider,
  [in] LPCWSTR            pszAlgId,
  [in] DWORD              dwFlags
);

Parametri

[in] hProvider

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

[in] pszAlgId

Puntatore a una stringa Unicode con terminazione Null che identifica l'algoritmo di crittografia in questione. Può trattarsi di uno degli identificatori di algoritmo CNG standard o dell'identificatore per un altro algoritmo registrato.

[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	Il provider supporta l'algoritmo specificato.
NTE_BAD_FLAGS	Il parametro dwFlags contiene uno o più flag non supportati.
NTE_INVALID_HANDLE	L'handle specificato dal parametro hProvider non è valido.
NTE_INVALID_PARAMETER	Uno o più parametri non sono validi.
NTE_NOT_SUPPORTED	Il provider non supporta l'algoritmo specificato.

Commenti

Se il provider supporta l'algoritmo, questa funzione restituisce ERROR_SUCCESS. Se il provider non supporta l'algoritmo e non si sono verificati altri errori, questa funzione restituisce NTE_NOT_SUPPORTED.

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 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	ncrypt.h
Libreria	Ncrypt.lib
DLL	Ncrypt.dll

Condividi tramite