Metodo UnlockWithNumericalPassword della classe Win32_EncryptableVolume

Articolo
06/13/2023

Il metodo UnlockWithNumericalPassword della classe Win32_EncryptableVolume usa una password numerica fornita per accedere al contenuto di un volume di dati.

La chiave di crittografia del volume deve essere stata protetta con una o più protezioni con chiave del tipo "Password numerica" (usando il metodo ProtectKeyWithNumericalPassword ) per poter sbloccare il volume con questo metodo.

Nota

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

Sintassi

uint32 UnlockWithNumericalPassword(
  [in] string NumericalPassword
);

Parametri

NumericPassword [in]

Tipo: string

Stringa che specifica la password numerica.

La password numerica deve contenere 48 cifre. Queste cifre possono essere suddivise in 8 gruppi di 6 cifre, con l'ultima cifra in ogni gruppo che indica un valore di checksum per il gruppo. Ogni gruppo di 6 cifre deve essere divisibile per 11 e deve essere minore di 65536. Supponendo che un gruppo di sei cifre sia etichettato come x1, x2, x3, x4, x5 e x6, il checksum x6 cifre viene calcolato come –x1+x2–x3+x4–x5 mod 11.

I gruppi di cifre possono essere separati facoltativamente da uno spazio o da un trattino. Pertanto, "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" o "xxxxxx xxxxxx" può contenere anche password numeriche valide.

Valore restituito

Tipo: uint32

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

Se il volume è già sbloccato e non si verificano altri errori, questo metodo restituisce 0.

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 con chiave per abilitare BitLocker.
FVE_E_PROTECTOR_NOT_FOUND 2150694963 (0x80310033)	Il volume non dispone di una protezione con chiave del tipo "Password numerica". Il parametro NumericPassword ha un formato valido, ma non è possibile usare una password numerica per sbloccare il volume.
FVE_E_FAILED_AUTHENTICATION 2150694951 (0x80310027)	Il parametro NumericPassword non può sbloccare il volume. Esistono una o più protezioni con chiave del tipo "Password numerica", ma il parametro NumericPassword specificato non può sbloccare il volume.
FVE_E_INVALID_PASSWORD_FORMAT 2150694965 (0x80310035)	Il parametro NumericPassword non ha un formato valido.

Commenti

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

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

Vedi anche

Win32_EncryptableVolume