UnlockWithNumericalPassword-Methode der Win32 _ EncryptableVolume-Klasse

Die UnlockWithNumericalPassword-Methode der Win32 _ EncryptableVolume-Klasse verwendet ein bereitgestelltes numerisches Kennwort für den Zugriff auf den Inhalt eines Datenvolumes.

Der Verschlüsselungsschlüssel des Volumes muss mit einer oder mehrere Schlüsselschutzvorrichtungen des Typs "Numerisches Kennwort" (mithilfe der ProtectKeyWithNumericalPassword-Methode) gesichert worden sein, um das Volume mit dieser Methode entsperren zu können.

Hinweis

Wenn der Datenträger Hardwareverschlüsselung unterstützt, legt diese Funktion den Bandstatus auf "Entsperrt" fest.

Syntax

uint32 UnlockWithNumericalPassword(
  [in] string NumericalPassword
);

Parameter

NumericalPassword [ In]

Typ: Zeichenfolge

Eine Zeichenfolge, die das numerische Kennwort angibt.

Das numerische Kennwort muss 48 Ziffern enthalten. Diese Ziffern können in acht Gruppen von sechs Ziffern unterteilt werden, und die letzte Ziffer in jeder Gruppe gibt einen Prüfsummenwert für die Gruppe an. Jede Gruppe von 6 Ziffern muss durch 11 teilbar sein und kleiner als 65536 sein. Wenn eine Gruppe von sechs Ziffern als x1, x2, x3, x4, x5 und x6 bezeichnet wird, wird die Prüfsumme x6-Ziffer als –x1+x2–x3+x4-x5 mod 11 berechnet.

Die Gruppen von Ziffern können optional durch ein Leerzeichen oder bindestrich getrennt werden. Daher können "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" oder "xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx" ebenfalls gültige numerische Kennwörter enthalten.

Rückgabewert

Typ: uint32

Diese Methode gibt einen der folgenden Codes oder einen anderen Fehlercode zurück, wenn ein Fehler auftritt.

Wenn das Volume bereits entsperrt ist und keine anderen Fehler auftreten, gibt diese Methode 0 zurück.

Rückgabecode/-wert BESCHREIBUNG
S _ OK
0 (0x0)
Die Methode war erfolgreich.
FVE _ E _ NOT _ ACTIVATED
2150694920 (0x80310008)
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren.
FVE _ E _ PROTECTOR _ NOT _ FOUND
2150694963 (0x80310033)
Das Volume verfügt nicht über eine Schlüsselschutzvorrichtung vom Typ "Numerisches Kennwort".
Der Parameter NumericalPassword hat ein gültiges Format, Sie können jedoch kein numerisches Kennwort verwenden, um das Volume zu entsperren.
FVE _ E _ FAILED _ AUTHENTICATION
2150694951 (0x80310027)
Der Parameter NumericalPassword kann das Volume nicht entsperren.
Eine oder mehrere Schlüsselschutzvorrichtungen vom Typ "Numerisches Kennwort" sind vorhanden, aber der angegebene NumericalPassword-Parameter kann das Volume nicht entsperren.
FVE _ E _ _ UNGÜLTIGES _ KENNWORTFORMAT
2150694965 (0x80310035)
Der Parameter NumericalPassword hat kein gültiges Format.

Hinweise

Managed Object Format -Dateien (MOF) enthalten die Definitionen für Windows WMI-Klassen (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. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista Enterprise, 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