SaveExternalKeyToFile-Methode der Win32_EncryptableVolume-Klasse
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 |
|---|---|
|
Die Methode war erfolgreich. |
|
Das Volume ist gesperrt. |
|
Der Parameter VolumeKeyProtectorID verweist nicht auf einen Schlüsselschutz vom Typ "Externer Schlüssel" oder "TPM und Startschlüssel". |
|
Der Path-Parameter verweist nicht auf einen gültigen Speicherort. Stellen Sie sicher, dass der Dateiname nicht im Path-Parameter enthalten ist. |
|
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 |
|
Siehe auch