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 |
|---|---|
|
Die Methode war erfolgreich. |
|
Der NewExternalKey-Parameter ist kein Array der Größe 32. |
|
Das Volume ist gesperrt. |
|
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren. |
|
Auf diesem Computer befindet sich eine startbare CD/DVD. Entfernen Sie die CD/DVD, und starten Sie den Computer neu. |
|
Die bereitgestellte Schlüsselschutzvorrichtung ist auf dem Volume nicht vorhanden. |
|
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 |
|