GetKeyProtectorExternalKey-Methode der Win32_EncryptableVolume-Klasse

Die GetKeyProtectorExternalKey-Methode der Win32_EncryptableVolume-Klasse ruft den externen Schlüssel für einen bestimmten Schlüsselschutz des entsprechenden Typs ab.

Der Schlüsselschutzbezeichner muss auf eine Schlüsselschutzvorrichtung vom Typ "Externer Schlüssel", "TPM und PIN und Startschlüssel" oder "TPM und Startschlüssel" verweisen.

Syntax

uint32 GetKeyProtectorExternalKey(
  [in]  string VolumeKeyProtectorID,
  [out] uint8  ExternalKey[]
);

Parameter

VolumeKeyProtectorID [in]

Typ: Zeichenfolge

Ein eindeutiger Zeichenfolgenbezeichner, der zum Verwalten einer verschlüsselten Volumeschlüsselschutzvorrichtung verwendet wird.

ExternalKey [out]

Typ: uint8[]

Ein Bytearray, das den externen 256-Bit-Schlüssel angibt, der zum Entsperren des entsprechenden Volumes verwendet werden kann.

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.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
Das Volume ist gesperrt.
E_INVALIDARG
2147942487 (0x80070057)
Der Parameter VolumeKeyProtectorID verweist nicht auf einen Schlüsselschutz vom Typ "Externer Schlüssel", "TPM und PIN und Startschlüssel" oder "TPM und Startschlüssel".
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
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 des Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Verwaltetes Objektformat (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
Win32_encryptablevolume.mof

Weitere Informationen

Win32_EncryptableVolume