Freigeben über

ProtectKeyWithNumericalPassword-Methode der Win32_EncryptableVolume-Klasse

Die ProtectKeyWithNumericalPassword-Methode der Win32_EncryptableVolume Klasse sichert den Verschlüsselungsschlüssel des Volumes mit einem speziell formatierten 48-stelligen Kennwort. Dieses numerische Kennwort kann verwendet werden, um die Authentifizierungsfehler anderer Schlüsselschutzkomponenten (z. B. TPM) wiederherzustellen.

Für das Volume wird eine Schlüsselschutzvorrichtung vom Typ "Numerisches Kennwort" erstellt.

Verwenden Sie die IsNumericalPasswordValid-Methode , um das Format des numerischen Kennworts zu überprüfen.

Syntax

uint32 ProtectKeyWithNumericalPassword(
  [in, optional] string FriendlyName,
  [in, optional] string NumericalPassword,
  [out]          string VolumeKeyProtectorID
);

Die Parameter

FriendlyName [in, optional]

Typ: Zeichenfolge

Eine Zeichenfolge, die einen benutzerdefinierten Bezeichner für diese Schlüsselschutzkomponente angibt. Wenn dieser Parameter nicht angegeben ist, wird ein leerer Wert verwendet.

NumerischPassword [in, optional]

Typ: Zeichenfolge

Eine Zeichenfolge, die das speziell formatierte numerische Kennwort mit 48 Ziffern angibt.

Das numerische Kennwort muss 48 Ziffern enthalten. Diese Ziffern können in 8 Gruppen von 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 dividierbar sein und muss 720885 oder kleiner 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 Bindestrich getrennt werden. Daher kann "xx-xx-xx-xx-xxxxxx-xx-xx-xx" oder "xx xxxxxx" auch gültige numerische Kennwörter enthalten.

Wenn kein numerisches Kennwort angegeben wird, wird ein Kennwort zufällig generiert. Verwenden Sie die GetKeyProtectorNumericalPassword-Methode , um das zufällig generierte Kennwort abzurufen.

VolumeKeyProtectorID [out]

Typ: Zeichenfolge

Eine Zeichenfolge, die der eindeutigen ID entspricht, die der erstellten Schutzkomponente zugeordnet ist und zum Verwalten der Schlüsselschutzkomponente verwendet werden kann.

Wenn das Laufwerk die Hardwareverschlüsselung unterstützt und BitLocker den Besitz des Bandes nicht übernommen hat, wird die ID-Zeichenfolge auf "BitLocker" festgelegt, und die Schlüsselschutzvorrichtung wird pro Bandmetadaten geschrieben.

Rückgabewert

Typ: uint32

Diese Methode gibt einen der folgenden Codes oder einen anderen Fehlercode zurück, wenn er fehlschlägt.

Zurückgeben von Code/Wert BESCHREIBUNG
S_OK
0 (0x0)
 Die Methode war erfolgreich.
E_INVALIDARG
2147942487 (0x80070057)
 Der Parameter "NumericalPassword" verfügt nicht über ein gültiges Format.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Das Volume ist gesperrt.
FVE_E_INVALID_PASSWORD_FORMAT
2150694965 (0x80310035)
 Der Parameter "NumericalPassword" 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-Managers hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

Anforderungen

Anforderung Wert
Mindest unterstützter Client
 Windows Vista Enterprise, Windows Vista Ultimate [nur Desktop-Apps]
Unterstützter Mindestserver
 Windows Server 2008 [Nur Desktop-Apps]
Namespace
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Siehe auch

Win32_EncryptableVolume

 

 

  • Last updated on