UnlockWithExternalKey-Methode der Win32_EncryptableVolume-Klasse
Die UnlockWithExternalKey-Methode der Win32_EncryptableVolume-Klasse verwendet einen bereitgestellten externen Schlüssel, um auf den Inhalt eines Datenvolumes zuzugreifen.
Der Verschlüsselungsschlüssel des Volumes muss mit einer oder mehreren Schlüsselschutzvorrichtungen vom Typ "Externer Schlüssel" mithilfe der ProtectKeyWithExternalKey-Methode gesichert worden sein, um das Volume mit dieser Methode entsperren zu können.
Hinweis
Wenn der Datenträger die Hardwareverschlüsselung unterstützt, legt diese Funktion das Band status auf "entsperrt" fest.
Syntax
uint32 UnlockWithExternalKey(
[in] uint8 ExternalKey[]
);
Parameter
-
ExternalKey [in]
-
Typ: uint8[]
Ein Bytearray, das den 256-Bit-externen Schlüssel angibt, der zum Entsperren des Volumes verwendet wird. Dieser Schlüssel kann durch Aufrufen der GetExternalKeyFromFile-Methode abgerufen werden.
Rückgabewert
Typ: uint32
Diese Methode gibt einen der folgenden Codes oder einen anderen Fehlercode zurück, wenn sie fehlschlägt.
Wenn das Volume bereits entsperrt ist, gibt diese Methode 0 zurück.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Methode war erfolgreich. |
|
Das Volume verfügt nicht über eine Schlüsselschutzvorrichtung vom Typ "Externer Schlüssel". |
|
Mindestens eine Schlüsselschutzvorrichtung vom Typ "Externer Schlüssel" ist vorhanden, aber der angegebene ExternalKey-Parameter kann das Volume nicht entsperren. |
|
Der Parameter ExternalKey ist kein Array der Größe 4. |
|
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren. |
Bemerkungen
MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen (Windows 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 hinzufügen. 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 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Namespace |
Root\CIMV2\Security\MicrosoftVolumeEncryption |
| MOF |
|
Weitere Informationen