ChangeExternalKey-Methode der Win32 _ EncryptableVolume-Klasse

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 Bytearray, 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 NewExternalKey-Parameter 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-SCHUTZVORRICHTUNG _ WURDE 2150694963
(0x80310033)
Die bereitgestellte Schlüsselschutzvorrichtung ist auf dem Volume nicht vorhanden.
FVE _ E _ INVALID PROTECTOR TYPE _ _ 2150694970
(0x8031003A)
Der VolumeKeyProtectorID-Parameter bezieht sich nicht auf eine Schlüsselschutzvorrichtung 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.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 7 Enterprise, Windows 7 [ Ultimate-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server 2008 [ R2-Desktop-Apps]
Namespace
\CimV2-Stammsicherheit \ \ MicrosoftVolumeEncryption
MOF
Win32 _ encryptablevolume.mof

Weitere Informationen

Win32 _ EncryptableVolume