Metodo ChangeExternalKey della classe Win32_EncryptableVolume

Articolo
06/13/2023

Il metodo ChangeExternalKey della classe Win32_EncryptableVolume modifica una chiave esterna associata a un volume crittografato.

Sintassi

uint32 ChangeExternalKey(
  [in]           string VolumeKeyProtectorID,
  [in, optional] uint8   NewExternalKey[],
  [out]          string NewVolumeKeyProtectorID
);

Parametri

VolumeKeyProtectorID [in]

Tipo: string

Identificatore di stringa univoco usato per gestire una protezione con chiave del volume crittografata.

NewExternalKey [in, facoltativo]

Tipo: uint8[]

Matrice di byte che specifica la chiave esterna a 256 bit usata per sbloccare il volume.

NewVolumeKeyProtectorID [out]

Tipo: string

Identificatore di stringa univoco aggiornato usato per gestire una protezione con chiave del volume crittografata.

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 NewExternalKey non è una matrice di dimensioni 32.
FVE_E_LOCKED_VOLUME 2150694912 (0x80310000)	Il volume è bloccato.
FVE_E_NOT_ACTIVATED 2150694920 (0x80310008)	Nel volume non è abilitato BitLocker. Aggiungere una protezione con chiave per abilitare BitLocker.
FVE_E_BOOTABLE_CDDVD 2150694960 (0x80310030)	Un CD/DVD di avvio si trova in questo computer. Rimuovere il CD/DVD e riavviare il computer.
FVE_E_PROTECTOR_NOT_FOUND 2150694963 (0x80310033)	La protezione con chiave fornita non esiste nel volume.
FVE_E_INVALID_PROTECTOR_TYPE 2150694970 (0x8031003A)	Il parametro VolumeKeyProtectorID non fa riferimento a una protezione con chiave del tipo "Password numerica" o "Chiave esterna". Utilizzare il metodo ProtectKeyWithNumericalPassword o ProtectKeyWithExternalKey per creare una protezione con chiave del tipo appropriato.

Commenti

Questo metodo può essere usato per modificare la chiave esterna per qualsiasi protezione con chiave che usa una chiave esterna.

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

Condividi tramite