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.
NTSTATUS BCryptAddContextFunction(
[in] ULONG dwTable,
[in] LPCWSTR pszContext,
[in] ULONG dwInterface,
[in] LPCWSTR pszFunction,
[in] ULONG dwPosition
);
[in] dwTable
Identifica la tabella di configurazione presente nel contesto. Questo può essere uno dei valori seguenti.
Valore | Significato |
---|---|
|
Il contesto esiste nella tabella di configurazione del computer locale. |
|
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.
[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.
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 |
---|---|
|
La funzione ha avuto esito positivo. |
|
Uno o più parametri non sono validi. |
|
Si è verificato un errore di allocazione della memoria. |
|
Impossibile trovare il contesto. |
Se la funzione aggiunta è già presente nell'elenco, verrà rimossa e inserita nella nuova posizione.
BCryptAddContextFunction può essere chiamato solo in modalità utente.
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 |