ProtectKeyWithPassphrase-Methode der Win32 _ EncryptableVolume-Klasse
Die ProtectKeyWithPassphrase-Methode der Win32 _ EncryptableVolume-Klasse verwendet die Passphrase, um den abgeleiteten Schlüssel abzurufen. Nachdem der abgeleitete Schlüssel berechnet wurde, wird der abgeleitete Schlüssel verwendet, um den Hauptschlüssel des verschlüsselten Volumes zu sichern.
Syntax
uint32 ProtectKeyWithPassphrase(
[in, optional] string FriendlyName,
[in] string Passphrase,
[out] string VolumeKeyProtectorID
);
Parameter
-
FriendlyName [ in, optional]
-
Typ: Zeichenfolge
Eine Zeichenfolge, die einen vom Benutzer zugewiesenen Zeichenfolgenbezeichner für diese Schlüsselschutzvorrichtung angibt. Wenn dieser Parameter nicht angegeben ist, wird ein leerer Wert verwendet.
-
Passphrase [ In]
-
Typ: Zeichenfolge
Eine Zeichenfolge, die die Passphrase angibt.
-
VolumeKeyProtectorID [ out]
-
Typ: Zeichenfolge
Eine Zeichenfolge, die die erstellte Schlüsselschutzvorrichtung eindeutig identifiziert.
Wenn das Laufwerk Hardwareverschlüsselung unterstützt und BitLocker keinen Bandbesitz übernommen hat, wird die ID-Zeichenfolge auf "BitLocker" festgelegt, und die Schlüsselschutzvorrichtung wird pro Bandmetadaten in geschrieben.
Rückgabewert
Typ: uint32
Diese Methode gibt einen der folgenden Codes oder einen anderen Fehlercode zurück, wenn er fehlschlägt.
| Rückgabecode/-wert | Beschreibung |
|---|---|
|
Die Methode war erfolgreich. |
|
BitLocker-Laufwerkverschlüsselung können nur zu Wiederherstellungszwecken verwendet werden, wenn sie im Tresor Modus verwendet werden. |
|
Die Gruppenrichtlinie lässt die Erstellung einer Passphrase nicht zu. |
|
Die Gruppenrichtlinieneinstellung, die FIPS-Konformität erfordert, hat verhindert, dass die Passphrase generiert oder verwendet wird. |
|
Die angegebene Passphrase erfüllt nicht die Mindest- oder Höchstlängenanforderungen. |
|
Die Passphrase erfüllt nicht die Komplexitätsanforderungen, die der Administrator in der Gruppenrichtlinie festgelegt hat. |
|
Das Volume ist bereits durch BitLocker-Laufwerkverschlüsselung gesperrt. Sie müssen das Laufwerk aus Systemsteuerung entsperren. |
|
Der Kontrollblock für das verschlüsselte Volume wurde von einem anderen Thread aktualisiert. |
|
Die Schlüsselschutzvorrichtung wird von der Version von BitLocker-Laufwerkverschlüsselung derzeit auf dem Volume nicht unterstützt. |
|
Die Passphrase kann dem Betriebssystemvolume nicht hinzugefügt werden. |
|
Die bereitgestellte Schlüsselschutzvorrichtung ist bereits auf diesem Volume vorhanden. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 7 Enterprise, nur Windows 7 [ Ultimate-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server 2008 [ R2-Desktop-Apps] |
| Namespace |
\CIMV2-Stammsicherheit \ \ MicrosoftVolumeEncryption |
| MOF |
|