SaveExternalKeyToFile-Methode der Win32_EncryptableVolume-Klasse

  • Artikel

Die SaveExternalKeyToFile-Methode der Win32_EncryptableVolume-Klasse schreibt den externen Schlüssel, der dem angegebenen Volumeschlüsselschutz 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 gespeichert werden soll, der dem angegebenen Schlüsselschutz zugeordnet ist. Dieser Pfad enthält nicht den Namen der Datei, die intern ist und sich möglicherweise von Version zu Version ändert. 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 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" oder "TPM und Startschlüssel".
ERROR_PATH_NOT_FOUND
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_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

Siehe auch

Win32_EncryptableVolume