Funzione BCryptAddContextFunction (bcrypt.h)

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

La funzione BCryptAddContextFunction aggiunge una funzione crittografica all'elenco di funzioni supportate da un contesto CNG esistente.

Sintassi

NTSTATUS BCryptAddContextFunction(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] ULONG   dwPosition
);

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 a cui aggiungere la funzione.

[in] dwInterface

Identifica l'interfaccia crittografica a cui aggiungere la funzione. Questo può essere uno dei valori seguenti.

Valore Significato
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
Aggiungere la funzione all'elenco di funzioni di crittografia asimmetrica.
BCRYPT_CIPHER_INTERFACE
Aggiungere la funzione all'elenco di funzioni di crittografia.
BCRYPT_HASH_INTERFACE
Aggiungere la funzione all'elenco di funzioni hash.
BCRYPT_RNG_INTERFACE
Aggiungere la funzione all'elenco di funzioni del generatore di numeri casuali.
BCRYPT_SECRET_AGREEMENT_INTERFACE
Aggiungere la funzione all'elenco delle funzioni del contratto segreto.
BCRYPT_SIGNATURE_INTERFACE
Aggiungere la funzione all'elenco di funzioni di firma.
NCRYPT_KEY_STORAGE_INTERFACE
Aggiungere la funzione all'elenco delle funzioni di archiviazione delle chiavi.
NCRYPT_SCHANNEL_INTERFACE
Aggiungere la funzione all'elenco di funzioni Schannel.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE
Aggiungere la funzione all'elenco di suite di firma che Schannel accetterà 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 da aggiungere.

[in] dwPosition

Specifica la posizione nell'elenco in cui inserire questa funzione. La funzione viene inserita in questa posizione prima di qualsiasi funzione esistente. Il valore CRYPT_PRIORITY_TOP viene usato per inserire la funzione nella parte superiore dell'elenco. Il valore CRYPT_PRIORITY_BOTTOM viene usato per inserire la funzione alla fine dell'elenco.

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.
STATUS_NOT_FOUND
Impossibile trovare il contesto.

Commenti

Se la funzione aggiunta è già presente nell'elenco, verrà rimossa e inserita nella nuova posizione.

BCryptAddContextFunction 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

BCryptRemoveContextFunction