Funzione NCryptCreatePersistedKey (ncrypt.h)

La funzione NCryptCreatePersistedKey crea una nuova chiave e la archivia nel provider di archiviazione chiavi specificato. Dopo aver creato una chiave usando questa funzione, è possibile usare la funzione NCryptSetProperty per impostarne le proprietà; Tuttavia, la chiave non può essere usata finché non viene chiamata la funzione NCryptFinalizeKey .

Sintassi

SECURITY_STATUS NCryptCreatePersistedKey(
  [in]           NCRYPT_PROV_HANDLE hProvider,
  [out]          NCRYPT_KEY_HANDLE  *phKey,
  [in]           LPCWSTR            pszAlgId,
  [in, optional] LPCWSTR            pszKeyName,
  [in]           DWORD              dwLegacyKeySpec,
  [in]           DWORD              dwFlags
);

Parametri

[in] hProvider

Handle del provider di archiviazione delle chiavi in cui creare la chiave. Questo handle viene ottenuto usando la funzione NCryptOpenStorageProvider .

[out] phKey

Indirizzo di una variabile NCRYPT_KEY_HANDLE che riceve l'handle della chiave. Al termine dell'uso di questo handle, rilasciarlo passandolo alla funzione NCryptFreeObject . Per eliminare il file di chiave su disco, passare l'handle alla funzione NCryptDeleteKey . Verrà rilasciato anche l'handle. Le applicazioni possono quindi passare l'handle a NCryptFreeObject o NCryptDeleteKey, ma non a entrambe.

[in] pszAlgId

Puntatore a una stringa Unicode con terminazione Null contenente l'identificatore dell'algoritmo di crittografia per creare la chiave. Può trattarsi di uno degli identificatori di algoritmo CNG standard o dell'identificatore per un altro algoritmo registrato.

[in, optional] pszKeyName

Puntatore a una stringa Unicode con terminazione Null contenente il nome della chiave. Se questo parametro è NULL, questa funzione creerà una chiave temporanea che non è persistente.

[in] dwLegacyKeySpec

Identificatore legacy che specifica il tipo di chiave. I valori possibili sono i seguenti:

[in] dwFlags

Set di flag che modificano il comportamento di questa funzione. Può essere zero o una combinazione di uno o più dei valori seguenti:

Valore restituito

Restituisce un codice di stato che indica l'esito positivo o negativo della funzione.

I codici restituiti possibili includono, a titolo esemplificativo, quanto segue:

Commenti

Se si crea una coppia di chiavi RSA, è anche possibile archiviare la chiave nell'archiviazione legacy in modo che possa essere usata con CryptoAPI passando il flag NCRYPT_WRITE_KEY_TO_LEGACY_STORE_FLAG alla funzione NCryptFinalizeKey al termine della chiave.

Un servizio non deve chiamare questa funzione dalla funzione StartService. Se un servizio chiama questa funzione dalla funzione StartService, può verificarsi un deadlock e il servizio potrebbe smettere di rispondere.

Requisiti hardware aggiuntivi per le chiavi VBS

Anche se nel computer potrebbe essere installato il sistema operativo appropriato, per generare e proteggere le chiavi è necessario soddisfare i requisiti hardware aggiuntivi seguenti.

• Virtualizzazione abilitata (vedere Sicurezza basata su virtualizzazione ))
• TPM abilitato
  • Per gli ambienti bare metal, è necessario TPM 2.0.
  • Per gli ambienti vm, vTPM (Virtual TPM) è supportato.
• Il BIOS deve essere aggiornato a UEFI con il profilo SecureBoot

Per altre informazioni sui requisiti hardware:

• VBS prevede diversi requisiti hardware da eseguire, tra cui Hyper-V (hypervisor Windows), architettura a 64 bit e supporto di IOMMU. L'elenco completo dei requisiti hardware vbs è disponibile qui.
• I requisiti per un dispositivo altamente sicuro sono disponibili qui.

Requisiti

Vedi anche

NCryptDeleteKey

NCryptFinalizeKey

NCryptImportKey