GetKeyPackage-Methode der Win32 _ EncryptableVolume-Klasse
Die GetKeyPackage-Methode der Win32 _ EncryptableVolume-Klasse exportiert Informationen, die bei der Wiederherstellung verschlüsselter Daten helfen können, wenn das Laufwerk stark beschädigt ist und keine Datensicherungsdateien vorhanden sind.
Die exportierten Informationen bestehen aus dem Verschlüsselungsschlüssel des Volumes, der durch eine Schlüsselschutzvorrichtung vom Typ "Numerisches Kennwort" oder "Externer Schlüssel" gesichert wird. Um dieses Paket verwenden zu können, müssen Sie auch das entsprechende numerische Kennwort oder den externen Schlüssel speichern.
Wichtig
Wenn Sie ein Schlüsselpaket exportieren möchten, stellen Sie sicher, dass diese Informationen an einem gut geschützten Speicherort bleiben. Tragen Sie diese Informationen nicht mit Ihrem Computer. Wenn dieses Schlüsselpaket verloren geht oder gestohlen wird, müssen Sie das Volume entschlüsseln und es mit einem neuen Schlüssel erneut verschlüsseln.
Im Falle eines Laufwerkausfalls ist das BitLocker-Reparaturtool vorhanden, um verfügbare Daten zu erhalten. Weitere Informationen dazu, wie dieses Tool das Schlüsselpaket verwenden kann, finden Sie unter How to use the BitLocker Repair Toolto help recover data from an encrypted volume in Windows Vista .
Syntax
uint32 GetKeyPackage(
[in] string VolumeKeyProtectorID,
[out] uint8 KeyPackage[]
);
Parameter
-
VolumeKeyProtectorID [ In]
-
Typ: Zeichenfolge
Ein eindeutiger Zeichenfolgenbezeichner, der zum Verwalten einer verschlüsselten Volumeschlüsselschutzvorrichtung verwendet wird. Zum Exportieren eines Schlüsselpakets müssen Sie eine Schlüsselschutzvorrichtung vom Typ "Numerisches Kennwort" oder "Externer Schlüssel" verwenden.
-
KeyPackage [ ] [out]
-
Typ: uint8
Ein Bytestream, der den Verschlüsselungsschlüssel für ein Volume enthält, der durch die angegebene Schlüsselschutzvorrichtung geschützt 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. |
|
Das Volume ist gesperrt. |
|
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren. |
|
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. |
Hinweise
Managed Object Format -Dateien (MOF) enthalten die Definitionen für Windows WMI-Klassen (Management Instrumentation). MOF-Dateien werden nicht als Teil des Windows SDK installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe der Server-Manager. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista Enterprise, Windows Vista [ Ultimate-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Namespace |
\CimV2-Stammsicherheit \ \ MicrosoftVolumeEncryption |
| MOF |
|