UnlockWithCertificateThumbprint della classe Win32_EncryptableVolume

  • Articolo

Il metodo UnlockWithCertificateThumbprint della classe Win32_EncryptableVolume usa l'identificazione personale del certificato fornita 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 UnlockWithCertificateThumbprint(
  [in] string CertThumbprint,
  [in] string PIN
);

Parametri

CertThumbprint [in]

Tipo: stringa

Viene accettato un valore di identificazione personale pari a 0 e viene eseguita una ricerca dell'archivio locale per il certificato appropriato. Se viene trovato un singolo certificato BitLocker, la ricerca ha esito positivo. Se non viene trovato alcun certificato o più certificati, il metodo ha esito negativo.

PIN [in]

Tipo: stringa

Stringa di identificazione personale specificata dall'utente. Questa stringa deve essere costituita da una sequenza di 4 a 20 cifre. Questa stringa viene usata per autenticare in modo automatico il provider di archiviazione delle 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 se ha esito negativo.

Codice/valore restituito Descrizione
S_OK
0 (0x0)
 Il metodo è stato eseguito correttamente.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 Nel volume non è abilitato BitLocker. Aggiungere una protezione chiave per abilitare BitLocker.
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
 Impossibile sbloccare il volume usando le informazioni fornite.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 La protezione chiave fornita non esiste nel volume. È necessario immettere un'altra protezione chiave.
FVE_E_PRIVATEKEY_AUTH_FAILED
2150695060 (0x80310094)
 Impossibile autorizzare la chiave privata associata al certificato specificato. L'autorizzazione della chiave privata non è stata fornita o l'autorizzazione fornita 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