Metodo UnlockWithCertificateFile della classe Win32_EncryptableVolume

  • Articolo

Il metodo UnlockWithCertificateFile della classe Win32_EncryptableVolume usa il file di certificato fornito per ottenere la chiave derivata e sbloccare il volume crittografato.

Nota

Se il disco supporta la crittografia hardware, questa funzione imposta lo stato della banda su "sbloccato"

 

Sintassi

uint32 UnlockWithCertificateFile(
  [in] string FileName,
  [in] string PIN
);

Parametri

FileName [in]

Tipo: string

Stringa che specifica il percorso e il nome del file cer utilizzato per recuperare l'identificazione personale del certificato. Un certificato di crittografia deve essere esportato in formato cer (Distinguished Encoding Rules (DER) binario con codifica X.509 o Con codifica Base 64 X.509. Il certificato di crittografia può essere generato dall'infrastruttura PKI Microsoft, dall'infrastruttura a chiave pubblica di terze parti o autofirmata.

PIN [in]

Tipo: string

Stringa di identificazione personale specificata dall'utente. Questa stringa deve essere costituita da una sequenza da 4 a 20 cifre. Questa stringa viene usata per autenticare automaticamente il provider di archiviazione chiavi (KSP) quando usato con una smart card.

Valore restituito

Tipo: uint32

Questo metodo restituisce uno dei codici seguenti o un altro codice di errore in caso di errore.

Codice/valore restituito Descrizione
S_OK
0 (0x0)
 Il metodo è stato eseguito correttamente.
ERROR_FILE_NOT_FOUND
0000000002 (0x2)
 Il sistema non può archiviare il file specificato.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 Nel volume non è abilitato BitLocker. Aggiungere una protezione con chiave per abilitare BitLocker.
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
 Il volume non può essere sbloccato con le informazioni fornite.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 La protezione con chiave fornita non esiste nel volume. È necessario immettere un'altra protezione con chiave.
FVE_E_PRIVATEKEY_AUTH_FAILED
2150695060 (0x80310094)
 Impossibile autorizzare la chiave privata associata al certificato specificato. L'autorizzazione della chiave privata non è stata specificata o l'autorizzazione specificata non è valida.

 

Requisiti

Requisito Valore
Client minimo supportato
 Windows 7 Enterprise, Windows 7 Ultimate [solo app desktop]
Server minimo supportato
 Windows Server 2008 R2 [solo app desktop]
Spazio dei nomi
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Vedi anche

Win32_EncryptableVolume