GetKeyProtectorNumericalPassword-Methode der Win32_EncryptableVolume-Klasse

Die GetKeyProtectorNumericalPassword-Methode der Win32_EncryptableVolume-Klasse ruft das numerische Kennwort für einen bestimmten Schlüsselschutz des entsprechenden Typs ab.

Der Schlüsselschutzbezeichner muss auf einen Schlüsselschutz vom Typ "Numerisches Kennwort" verweisen.

Syntax

uint32 GetKeyProtectorNumericalPassword(
  [in]  string VolumeKeyProtectorID,
  [out] string NumericalPassword
);

Parameter

VolumeKeyProtectorID [in]

Typ: Zeichenfolge

Ein eindeutiger Zeichenfolgenbezeichner, der zum Verwalten einer verschlüsselten Volumeschlüsselschutzvorrichtung verwendet wird.

NumericalPassword [out]

Typ: Zeichenfolge

Eine Zeichenfolge, die das Kennwort darstellt, mit dem das entsprechende Volume entsperrt werden kann.

Das numerische Kennwort ist 48 Ziffern. Diese Ziffern sind in 8 Gruppen mit 6 Ziffern unterteilt, wobei die letzte Ziffer in jeder Gruppe einen Prüfsummenwert für die Gruppe angibt. Unter der Annahme, dass 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 werden durch einen Bindestrich getrennt. Daher ist "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" das Format des zurückgegebenen Kennworts.

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.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
Das Volume ist gesperrt.
E_INVALIDARG
2147942487 (0x80070057)
Der Parameter VolumeKeyProtectorID verweist nicht auf einen Schlüsselschutz vom Typ "Numerisches Kennwort".
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
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
Win32_encryptablevolume.mof

Weitere Informationen

Win32_EncryptableVolume