Metodo ProtectKeyWithPassphrase della classe Win32_EncryptableVolume

  • Articolo

Il metodo ProtectKeyWithPassphrase della classe Win32_EncryptableVolume usa la passphrase per ottenere la chiave derivata. Dopo aver calcolato la chiave derivata, la chiave derivata viene usata per proteggere la chiave master del volume crittografato.

Sintassi

uint32 ProtectKeyWithPassphrase(
  [in, optional] string FriendlyName,
  [in]           string Passphrase,
  [out]          string VolumeKeyProtectorID
);

Parametri

FriendlyName [in, facoltativo]

Tipo: stringa

Stringa che specifica un identificatore di stringa assegnato dall'utente per questa protezione della chiave. Se questo parametro non è specificato, viene usato un valore vuoto.

Passphrase [in]

Tipo: stringa

Stringa che specifica la passphrase.

VolumeKeyProtectorID [out]

Tipo: stringa

Stringa che identifica in modo univoco la protezione chiave creata.

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 delle chiavi viene scritta in base ai metadati band.

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_ALLOWED_IN_SAFE_MODE
2150694976 (0x80310040)
 La crittografia unità BitLocker può essere usata solo per scopi di ripristino quando viene usata in modalità provvisoria.
FVE_E_POLICY_PASSPHRASE_NOT_ALLOWED
2150695018 (0x8031006A)
 Criteri di gruppo non consente la creazione di una passphrase.
FVE_E_FIPS_PREVENTS_PASSPHRASE
2150695020 (0x8031006C)
 L'impostazione dei criteri di gruppo che richiede la conformità FIPS impedisce la generazione o l'uso della passphrase.
FVE_E_POLICY_INVALID_PASSPHRASE_LENGTH
2150695040 (0x80310080)
 La passphrase fornita non soddisfa i requisiti minimi o massimi di lunghezza.
FVE_E_POLICY_PASSPHRASE_TOO_SIMPLE
2150695041 (0x80310081)
 La passphrase non soddisfa i requisiti di complessità impostati dall'amministratore nei criteri di gruppo.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Il volume è già bloccato da Crittografia unità BitLocker. È necessario sbloccare l'unità da Pannello di controllo.
FVE_E_OVERLAPPED_UPDATE
2150694948 (0x80310024)
 Il blocco di controllo per il volume crittografato è stato aggiornato da un altro thread.
FVE_E_KEY_PROTECTOR_NOT_SUPPORTED
2150695017 (0x80310069)
 La protezione delle chiavi non è supportata dalla versione di Crittografia unità BitLocker attualmente nel volume.
FVE_E_OS_VOLUME_PASSPHRASE_NOT_ALLOWED
2150695021 (0x8031006D)
 Impossibile aggiungere la passphrase al volume del sistema operativo.
FVE_E_PROTECTOR_EXISTS
2150694960 (0x80310030)
 La protezione chiave fornita esiste già in questo volume.

 

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