Funzione BCryptConfigureContextFunction (bcrypt.h)

Articolo
02/23/2024

[BCryptConfigureContextFunction è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

La funzione BCryptConfigureContextFunction imposta le informazioni di configurazione per la funzione di crittografia di un contesto CNG esistente.

Sintassi

NTSTATUS BCryptConfigureContextFunction(
  [in] ULONG                          dwTable,
  [in] LPCWSTR                        pszContext,
  [in] ULONG                          dwInterface,
  [in] LPCWSTR                        pszFunction,
  [in] PCRYPT_CONTEXT_FUNCTION_CONFIG pConfig
);

Parametri

[in] dwTable

Identifica la tabella di configurazione presente nel contesto. Questo può essere uno dei valori seguenti.

Valore	Significato
CRYPT_LOCAL	Il contesto esiste nella tabella di configurazione del computer locale.
CRYPT_DOMAIN	Questo valore non è disponibile per l'uso.

[in] pszContext

Puntatore a una stringa Unicode con terminazione null contenente l'identificatore del contesto per impostare le informazioni di configurazione della funzione crittografica per.

[in] dwInterface

Identifica l'interfaccia crittografica per impostare le informazioni di configurazione della funzione per. Questo può essere uno dei valori seguenti.

Valore	Significato
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Impostare le informazioni di configurazione della funzione nell'elenco delle funzioni di crittografia asimmetrica.
BCRYPT_CIPHER_INTERFACE	Impostare le informazioni di configurazione della funzione nell'elenco di funzioni di crittografia.
BCRYPT_HASH_INTERFACE	Impostare le informazioni di configurazione della funzione nell'elenco di funzioni hash.
BCRYPT_RNG_INTERFACE	Impostare le informazioni di configurazione della funzione nell'elenco delle funzioni del generatore di numeri casuali.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Impostare le informazioni di configurazione della funzione nell'elenco delle funzioni del contratto segreto.
BCRYPT_SIGNATURE_INTERFACE	Impostare le informazioni di configurazione della funzione nell'elenco delle funzioni di firma.
NCRYPT_KEY_STORAGE_INTERFACE	Impostare le informazioni di configurazione della funzione nell'elenco delle funzioni di archiviazione chiave.
NCRYPT_SCHANNEL_INTERFACE	Impostare le informazioni di configurazione della funzione nell'elenco di funzioni Schannel.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE	Impostare le informazioni di configurazione della funzione nell'elenco di suite di firme che Schannel accetta per TLS 1.2. Windows Vista e Windows Server 2008: Questo valore non è supportato.

[in] pszFunction

Puntatore a una stringa Unicode con terminazione null contenente l'identificatore della funzione crittografica per impostare le informazioni di configurazione per.

[in] pConfig

Indirizzo di una struttura CRYPT_CONTEXT_FUNCTION_CONFIG contenente le nuove informazioni di configurazione della funzione.

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.

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.

Commenti

BCryptConfigureContextFunction può essere chiamato solo in modalità utente.

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	bcrypt.h
Libreria	Bcrypt.lib
DLL	Bcrypt.dll

Vedi anche

CRYPT_CONTEXT_FUNCTION_CONFIG

Condividi tramite