UnlockWithNumericalPassword-Methode der Win32_EncryptableVolume-Klasse
Die UnlockWithNumericalPassword-Methode der Win32_EncryptableVolume-Klasse verwendet ein angegebenes numerisches Kennwort, um auf den Inhalt eines Datenvolumens zuzugreifen.
Der Verschlüsselungsschlüssel des Volumes muss mit einer oder mehreren Schlüsselschutzvorrichtungen vom Typ "Numerisches Kennwort" (mithilfe der ProtectKeyWithNumericalPassword-Methode ) gesichert worden sein, um das Volume mit dieser Methode entsperren zu können.
Hinweis
Wenn der Datenträger die Hardwareverschlüsselung unterstützt, legt diese Funktion das Band status 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 8 Gruppen mit 6 Ziffern unterteilt werden, wobei die letzte Ziffer in jeder Gruppe einen Prüfsummenwert für die Gruppe angibt. 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 Zifferngruppen können optional durch ein Leerzeichen oder einen Bindestrich getrennt werden. Daher können "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" oder "xxxxxx xxxxxx xx xx xx" auch 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 |
|---|---|
|
Die Methode war erfolgreich. |
|
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren. |
|
Das Volume verfügt nicht über eine Schlüsselschutzvorrichtung vom Typ "Numerisches Kennwort". Der NumerischePassword-Parameter hat ein gültiges Format, aber Sie können kein numerisches Kennwort verwenden, um das Volume zu entsperren. |
|
Der NumerischePassword-Parameter kann das Volume nicht entsperren. Mindestens eine Schlüsselschutzvorrichtung vom Typ "Numerisches Kennwort" ist vorhanden, aber der angegebene NumerischePassword-Parameter kann das Volume nicht entsperren. |
|
Der NumerischePassword-Parameter verfügt nicht über ein gültiges Format. |
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 |
|
Weitere Informationen