Funzione BCryptFinalizeKeyPair (bcrypt.h)

Articolo
07/16/2024

La funzione BCryptFinalizeKeyPair completa una coppia di chiavi pubblica/privata. La chiave non può essere usata fino a quando non viene chiamata questa funzione. 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 solo, quanto segue.

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.

Osservazioni

A seconda delle modalità del processore supportate da un provider, è possibile chiamare BCryptFinalizeKeyPair dalla modalità utente o dal 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 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [app desktop \| App UWP]
server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	bcrypt.h
libreria	Bcrypt.lib
dll	Bcrypt.dll

Vedere anche

BCryptGenerateKeyPair

Condividi tramite