Funzione BCryptFinalizeKeyPair (bcrypt.h)

  • Articolo

La funzione BCryptFinalizeKeyPair completa una coppia di chiavi pubblica/privata. La chiave non può essere usata finché questa funzione non è stata chiamata. Dopo aver chiamato questa funzione, la funzione BCryptSetProperty non può più essere usata per questa chiave.

Sintassi

NTSTATUS BCryptFinalizeKeyPair(
  [in, out] BCRYPT_KEY_HANDLE hKey,
  [in]      ULONG             dwFlags
);

Parametri

[in, out] hKey

Handle della chiave da completare. Questo handle viene ottenuto chiamando la funzione BCryptGenerateKeyPair .

[in] dwFlags

Set di flag che modificano il comportamento di questa funzione. Non sono attualmente definiti flag, quindi questo parametro deve essere zero.

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_HANDLE
 L'handle della chiave nel parametro hKey non è valido.
STATUS_INVALID_PARAMETER
 Uno o più parametri non sono validi.
STATUS_NOT_SUPPORTED
 Il provider specificato non supporta la crittografia della chiave asimmetrica.

Commenti

A seconda delle modalità di processore supportate da un provider, È possibile chiamare BCryptFinalizeKeyPair dalla modalità utente o dalla modalità kernel. I chiamanti in modalità kernel possono essere eseguiti in PASSIVE_LEVELIRQL o DISPATCH_LEVEL IRQL. Se il livello IRQL corrente è DISPATCH_LEVEL, l'handle fornito nel parametro hKey deve essere derivato da un handle di algoritmo restituito da un provider aperto con il flag di BCRYPT_PROV_DISPATCH .

Per chiamare questa funzione in modalità kernel, usare Cng.lib, che fa parte del Driver Development Kit (DDK). Windows Server 2008 e Windows Vista: Per chiamare questa funzione in modalità kernel, usare Ksecdd.lib.

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

Vedi anche

BCryptGenerateKeyPair