EncryptAfterHardwareTest della classe Win32_EncryptableVolume

Il metodo EncryptAfterHardwareTest della classe Win32_EncryptableVolume inizia la crittografia di un volume del sistema operativo completamente decrittografato dopo un test hardware. Per eseguire questo test hardware è necessario un riavvio. Usare questo metodo anziché il metodo Encrypt per verificare che BitLocker funzioni come previsto.

Sintassi

uint32 EncryptAfterHardwareTest(
  [in, optional] uint32 EncryptionMethod,
  [in, optional] uint32 EncryptionFlags
);

Parametri

EncryptionMethod [in, facoltativo]

Tipo: uint32

Specifica l'algoritmo di crittografia e le dimensioni delle chiavi usate per crittografare il volume. Lasciare vuoto questo parametro per usare il valore predefinito di zero. Se il volume è parzialmente o completamente crittografato, il valore di questo parametro deve essere 0 o corrispondere al metodo di crittografia esistente del volume. Se l'impostazione di Criteri di gruppo corrispondente è stata abilitata con un valore valido, il valore di questo parametro deve essere 0 o corrispondere all'impostazione Criteri di gruppo.

Se l'impostazione di Criteri di gruppo corrispondente non è valida, viene usata l'impostazione predefinita di AES 128 con il diffusore.

Valore	Significato
Non specificato 0	Usare l'impostazione di Criteri di gruppo corrente, se disponibile e valida o il metodo di crittografia predefinito in caso contrario.
1	AES 128 CON DIFFUSORE Crittografare il volume usando l'algoritmo Advanced Encryption Standard (AES) avanzato con un livello di diffusione e usando una dimensione della chiave AES di 128 bit.
2	AES 256 CON DIFFUSORE Crittografare il volume usando l'algoritmo Advanced Encryption Standard (AES) avanzato con un livello di diffusore e usando una dimensione della chiave AES di 256 bit.
AES_128 3	Crittografare il volume usando l'algoritmo Advanced Encryption Standard (AES) e usando una dimensione della chiave AES di 128 bit.
AES_256 4	Crittografare il volume usando l'algoritmo Advanced Encryption Standard (AES) e usando una dimensione della chiave AES di 256 bit.

 

EncryptionFlags [in, facoltativo]

Tipo: uint32

Flag che descrivono il comportamento di crittografia.

Windows 7, Windows Server 2008 R2, Windows Vista Enterprise e Windows Server 2008: Questo parametro non è disponibile.

Combinazione di 32 bit con i bit seguenti attualmente definiti.

Valore	Significato
0x00000001	Eseguire la crittografia dei volumi in modalità di crittografia solo dati quando si avvia un nuovo processo di crittografia. Se la crittografia è stata sospesa o arrestata, la chiamata al metodo Encrypt riprende in modo efficace la conversione e il valore di questo bit viene ignorato. Questo bit ha effetto solo quando i metodi Encrypt o EncryptAfterHardwareTest avviano la crittografia dallo stato completamente decrittografato, decrittografia in stato di avanzamento o decrittografia sospesa. Se questo bit è zero, significa che non è impostato, quando si avvia un nuovo processo di crittografia, verrà eseguita la conversione in modalità completa.
0x00000002	Eseguire la cancellazione su richiesta dello spazio libero del volume. La chiamata al metodo Encrypt con questo set di bit è consentita solo quando il volume non esegue la conversione o la cancellazione e si trova in uno stato "crittografato".
0x00010000	Eseguire l'operazione richiesta in modo sincrono. La chiamata verrà bloccata finché l'operazione richiesta non è stata completata o interrotta. Questo flag è supportato solo con il metodo Encrypt . Questo flag può essere specificato quando Encrypt viene chiamato per riprendere la crittografia arrestata o interrotta o la cancellazione o quando è in corso la crittografia o la cancellazione. Ciò consente al chiamante di riprendere in modo sincrono l'attesa fino al completamento o all'interruzione del processo.

 

Valore restituito

Tipo: uint32

Questo metodo restituisce uno dei codici seguenti o un altro codice di errore se ha esito negativo.

Questo metodo restituisce immediatamente. Se il volume è già crittografato e non vengono restituiti altri errori, questo metodo restituisce zero.

Commenti

Quando si usa questo metodo senza il secondo parametro facoltativo (in base alla definizione di Windows 7 e Windows Vista Enterprise), il metodo avvierà sempre la conversione in modalità completa per mantenere il comportamento compatibile con le versioni precedenti. In questo modo, le aspettative di sicurezza delle applicazioni e degli script esistenti non verranno interrotte con l'aggiunta del secondo parametro facoltativo in Windows 8 e Windows Server 2012.

A differenza del metodo Encrypt , questo metodo esegue le operazioni seguenti:

• Verifica se il TPM sarà in grado di sbloccare il volume, se esiste una protezione con chiave correlata al TPM.
• Verifica se il computer può leggere un'unità flash USB che contiene un file di chiave esterna durante l'avvio, se il volume verrà sbloccato da una chiave esterna (inclusa una chiave di avvio).
• Richiede un riavvio del computer per eseguire il test hardware.
• Avvia la crittografia solo se il test hardware ha esito positivo.
• Non può essere usato in un volume di dati, in un volume parzialmente o completamente crittografato o per riprendere la crittografia.

Prima di eseguire questo metodo, usare i metodi seguenti per creare le protezioni con chiave correlate:

• ProtectKeyWithExternalKey
• ProtectKeyWithTPM
• ProtectKeyWithTPMAndPIN
• ProtectKeyWithTPMAndPINAndStartupKey
• ProtectKeyWithTPMAndStartupKey

Dopo aver eseguito questo metodo, eseguire questi passaggi aggiuntivi:

1. Inserire nel computer un'unità flash USB contenente un file di chiave esterna. Questo passaggio si applica solo se il volume ha una protezione con chiave di tipo "Chiave esterna" o "TPM e chiave di avvio".
2. Riavviare il computer.

Al riavvio del computer, il test hardware viene eseguito automaticamente.

La crittografia inizia se il test hardware ha esito positivo. In caso contrario, tentare di risolvere eventuali errori hardware. Eseguire GetHardwareTestStatus dopo il riavvio del computer per ottenere i risultati del test.

I file MOF (Managed Object Format) contengono le definizioni per le classi WMI (Windows Management Instrumentation). I file MOF non vengono installati come parte di Windows SDK. Vengono installati nel server quando si aggiunge il ruolo associato usando il Server Manager. Per altre informazioni sui file MOF, vedere Managed Object Format (MOF).

Requisiti

Vedi anche

Win32_EncryptableVolume