UnlockWithExternalKey-Methode der Win32 _ EncryptableVolume-Klasse

Die UnlockWithExternalKey-Methode der Win32 _ EncryptableVolume-Klasse verwendet einen bereitgestellten externen Schlüssel für den Zugriff auf den Inhalt eines Datenvolumes.

Der Verschlüsselungsschlüssel des Volumes muss mit einer oder mehrere Schlüsselschutzvorrichtungen des Typs "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 Hardwareverschlüsselung unterstützt, legt diese Funktion den Bandstatus auf "Entsperrt" fest.

Syntax

uint32 UnlockWithExternalKey(
  [in] uint8 ExternalKey[]
);

Parameter

ExternalKey [ In]

Typ: uint8 [ ]

Ein Bytearray, das den externen 256-Bit-Schlüssel angibt, der zum Entsperren des Volumes verwendet wird. Dieser Schlüssel kann durch Aufrufen der GetExternalKeyFromFile-Methode ermittelt werden.

Rückgabewert

Typ: uint32

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

Wenn das Volume bereits entsperrt ist, gibt diese Methode 0 zurück.

Rückgabecode/-wert BESCHREIBUNG
S _ OK
0 (0x0)
Die Methode war erfolgreich.
FEHLER _ NICHT _ GEFUNDEN
Kein Wert angegeben (0x)
Das Volume verfügt nicht über eine Schlüsselschutzvorrichtung vom Typ "Externer Schlüssel".
FEHLER _ UNGÜLTIGES _ KENNWORT
Kein Wert angegeben (0x)
Mindestens eine Schlüsselschutzvorrichtung vom Typ "Externer Schlüssel" ist vorhanden, aber der angegebene ExternalKey-Parameter kann das Volume nicht entsperren.
E _ INVALIDARG
2147942487 (0x80070057)
Der ExternalKey-Parameter ist kein Array der Größe 4.
FVE _ E _ NOT _ ACTIVATED
2150694920 (0x80310008)
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren.

Hinweise

Managed Object Format (MOF) 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. 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
Win32 _ encryptablevolume.mof

Siehe auch

Win32 _ EncryptableVolume