SaveExternalKeyToFile-Methode der Win32 _ EncryptableVolume-Klasse

Die SaveExternalKeyToFile-Methode der Win32 _ EncryptableVolume-Klasse schreibt den externen Schlüssel, der der angegebenen Volumeschlüsselschutzvorrichtung zugeordnet ist, in eine ausgeblendete, schreibgeschützte Systemdatei im angegebenen Ordner.

Diese Methode gilt nur für Schlüsselschutzvorrichtungen vom Typ "Externer Schlüssel" oder "TPM und Startschlüssel".

Syntax

uint32 SaveExternalKeyToFile(
  [in] string VolumeKeyProtectorID,
  [in] string Path
);

Parameter

VolumeKeyProtectorID [ In]

Typ: Zeichenfolge

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

Pfad [ In]

Typ: Zeichenfolge

Eine Zeichenfolge, die den Volume- oder Ordnerspeicherort enthält, an dem der externe Schlüssel, der der angegebenen Schlüsselschutzvorrichtung zugeordnet ist, gespeichert werden soll. Dieser Pfad enthält nicht den Namen der Datei, die intern ist und sich von Version zu Version ändern kann. Verwenden Sie GetExternalKeyFileName, um den Dateinamen abzurufen.

Rückgabewert

Typ: uint32

Diese Methode gibt einen der folgenden Codes oder einen anderen Fehlercode zurück, wenn er fehlschlägt.

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 eine Schlüsselschutzvorrichtung vom Typ "Externer Schlüssel" oder "TPM und Startschlüssel".
FEHLER _ PFAD _ NICHT _ GEFUNDEN
2147942403 (0x80070003)
Der Path-Parameter verweist nicht auf einen gültigen Speicherort.
Stellen Sie sicher, dass der Dateiname nicht im Path-Parameter enthalten ist.
FVE _ E _ NICHT _ AKTIVIERT
2150694920 (0x80310008)
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren.

Hinweise

Managed Object Format -Dateien (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 hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista Enterprise, nur Windows Vista [ Ultimate-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Namespace
\CIMV2-Stammsicherheit \ \ MicrosoftVolumeEncryption
MOF
Win32 _ encryptablevolume.mof

Weitere Informationen

Win32 _ EncryptableVolume