Metodo ProtectKeyWithNumericalPassword della classe Win32_EncryptableVolume

  • Articolo

Il metodo ProtectKeyWithNumericalPassword della classe Win32_EncryptableVolume protegge la chiave di crittografia del volume con una password di 48 cifre appositamente formattata. Questa password numerica può essere usata per il ripristino dagli errori di autenticazione di altre protezioni con chiave,ad esempio TPM.

Viene creata una protezione con chiave di tipo "Password numerica" per il volume.

Utilizzare il metodo IsNumericalPasswordValid per convalidare il formato della password numerica.

Sintassi

uint32 ProtectKeyWithNumericalPassword(
  [in, optional] string FriendlyName,
  [in, optional] string NumericalPassword,
  [out]          string VolumeKeyProtectorID
);

Parametri

FriendlyName [in, facoltativo]

Tipo: string

Stringa che specifica un identificatore assegnato dall'utente per questa protezione con chiave. Se questo parametro non viene specificato, viene utilizzato un valore vuoto.

NumericPassword [in, facoltativo]

Tipo: string

Stringa che specifica la password numerica a 48 cifre appositamente formattata.

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 720885 o meno. 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.

Se non viene specificata alcuna password numerica, ne viene generata una in modo casuale. Utilizzare il metodo GetKeyProtectorNumericalPassword per ottenere la password generata in modo casuale.

VolumeKeyProtectorID [out]

Tipo: string

Stringa che rappresenta l'identificatore univoco associato alla protezione creata e che può essere usato per gestire la protezione con chiave.

Se l'unità supporta la crittografia hardware e BitLocker non ha acquisito la proprietà della banda, la stringa ID è impostata su "BitLocker" e la protezione con chiave viene scritta in per ogni metadati della banda.

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.
E_INVALIDARG
2147942487 (0x80070057)
 Il parametro NumericPassword non ha un formato valido.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Il volume è bloccato.
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