ChangeExternalKey-Methode der Win32_EncryptableVolume-Klasse

  • Artikel

Die ChangeExternalKey-Methode der Win32_EncryptableVolume-Klasse ändert einen externen Schlüssel, der einem verschlüsselten Volume zugeordnet ist.

Syntax

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

Parameter

VolumeKeyProtectorID [in]

Typ: Zeichenfolge

Ein eindeutiger Zeichenfolgenbezeichner, der zum Verwalten einer verschlüsselten Volumeschlüsselschutzvorrichtung verwendet wird.

NewExternalKey [in, optional]

Typ: uint8[]

Ein Array von Bytes, das den externen 256-Bit-Schlüssel angibt, der zum Entsperren des Volumes verwendet wird.

NewVolumeKeyProtectorID [out]

Typ: Zeichenfolge

Ein aktualisierter eindeutiger Zeichenfolgenbezeichner, der zum Verwalten einer verschlüsselten Volumeschlüsselschutzvorrichtung verwendet wird.

Rückgabewert

Typ: uint32

Diese Methode gibt einen der folgenden Codes oder einen anderen Fehlercode zurück, wenn ein Fehler auftritt.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0 (0x0)
 Die Methode war erfolgreich.
E_INVALIDARG
2147942487 (0x80070057)
 Der Parameter NewExternalKey ist kein Array der Größe 32.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Das Volume ist gesperrt.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren.
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
 Auf diesem Computer befindet sich eine startbare CD/DVD. Entfernen Sie die CD/DVD, und starten Sie den Computer neu.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 Die angegebene Schlüsselschutzvorrichtung ist auf dem Volume nicht vorhanden.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 Der Parameter VolumeKeyProtectorID verweist nicht auf einen Schlüsselschutz vom Typ "Numerisches Kennwort" oder "Externer Schlüssel". Verwenden Sie entweder die Methode ProtectKeyWithNumericalPassword oder ProtectKeyWithExternalKey , um eine Schlüsselschutzvorrichtung des entsprechenden Typs zu erstellen.

 

Bemerkungen

Diese Methode kann verwendet werden, um den externen Schlüssel für jede Schlüsselschutzvorrichtung zu ändern, die einen externen Schlüssel verwendet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 7 Enterprise, Windows 7 Ultimate [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2008 R2 [nur Desktop-Apps]
Namespace
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Siehe auch

Win32_EncryptableVolume