Lock-Methode der Win32_EncryptableVolume-Klasse

  • Artikel

Die Lock-Methode der Win32_EncryptableVolume-Klasse hebt die Bereitstellung des Volumes auf und entfernt den Verschlüsselungsschlüssel des Volumes aus dem Systemspeicher. Auf den Inhalt des Volumes kann nicht zugegriffen werden, bis es entweder mit der UnlockWithExternalKey-Methode oder der UnlockWithNumericalPassword-Methode entsperrt wird. Diese Methode kann für das derzeit ausgeführte Betriebssystemvolume nicht erfolgreich ausgeführt werden.

Hinweis

Wenn der Datenträger die Hardwareverschlüsselung unterstützt, wird das Band auf "gesperrt" festgelegt.

 

Syntax

uint32 Lock(
  [in, optional] boolean ForceDismount
);

Parameter

ForceDismount [in, optional]

Typ: boolesch

Wenn true , wird die Bereitstellung des Datenträgers gewaltsam aufgehoben.

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.
E_ACCESS_DENIED
2147942405 (0x80070005)
 Anwendungen greifen auf dieses Volume zu. Wenn der gesamte Zugriff nichtexklusiv ist, kann die Methode erfolgreich ausgeführt werden, wenn Sie den ForceDismount-Parameter als true angeben.
FVE_E_NOT_ENCRYPTED
2150694913 (0x80310001)
 Das Volume ist vollständig entschlüsselt und kann nicht gesperrt werden.
FVE_E_PROTECTION_DISABLED
2150694945 (0x80310021)
 Der Verschlüsselungsschlüssel des Volumes ist auf dem Datenträger in der Klarsicht verfügbar, wodurch verhindert wird, dass das Volume gesperrt wird.
FVE_E_RECOVERY_KEY_REQUIRED
2150694946 (0x80310022)
 Das Volume verfügt nicht über Schlüsselschutzvorrichtungen vom Typ "Numerisches Kennwort" oder "Externer Schlüssel", die zum Entsperren des Volumes erforderlich sind.

 

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