Funzione BCryptCreateContext (bcrypt.h)

  • Articolo

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

La funzione BCryptCreateContext crea un nuovo contesto di configurazione CNG.

Sintassi

NTSTATUS BCryptCreateContext(
  [in]           ULONG                 dwTable,
  [in]           LPCWSTR               pszContext,
  [in, optional] PCRYPT_CONTEXT_CONFIG pConfig
);

Parametri

[in] dwTable

Identifica la tabella di configurazione in cui creare il contesto. Questo può essere uno dei valori seguenti.

Valore Significato
CRYPT_LOCAL
 Creare il contesto 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 da creare.

[in, optional] pConfig

Puntatore a una struttura CRYPT_CONTEXT_CONFIG che contiene dati di configurazione aggiuntivi per il nuovo contesto. Questo parametro può essere NULL se non è necessario.

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

BCryptCreateContext 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