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
S _ OK
0 (0x0)
Die Methode war erfolgreich.
FVE _ E _ _ IST IM _ _ ABGESICHERTEN _ MODUS
2150694976 (0x80310040)
NICHT ZULÄSSIG.
BitLocker-Laufwerkverschlüsselung können nur zu Wiederherstellungszwecken verwendet werden, wenn sie im Tresor Modus verwendet werden.
FVE _ E _ POLICY _ PASSPHRASE _ NOT _ ALLOWED
2150695018 (0x8031006A)
Die Gruppenrichtlinie lässt die Erstellung einer Passphrase nicht zu.
FVE _ E _ FIPS _ VERHINDERT _ PASSPHRASE-2150695020
(0x8031006C)
Die Gruppenrichtlinieneinstellung, die FIPS-Konformität erfordert, hat verhindert, dass die Passphrase generiert oder verwendet wird.
FVE _ E _ POLICY _ INVALID _ PASSPHRASE _ LENGTH
2150695040 (0x80310080)
Die angegebene Passphrase erfüllt nicht die Mindest- oder Höchstlängenanforderungen.
FVE _ E _ POLICY _ PASSPHRASE _ TOO _ SIMPLE
2150695041 (0x80310081)
Die Passphrase erfüllt nicht die Komplexitätsanforderungen, die der Administrator in der Gruppenrichtlinie festgelegt hat.
FVE _ E _ LOCKED _ VOLUME
2150694912 (0x80310000)
Das Volume ist bereits durch BitLocker-Laufwerkverschlüsselung gesperrt. Sie müssen das Laufwerk aus Systemsteuerung entsperren.
FVE _ E _ OVERLAPPED _ UPDATE
2150694948 (0x80310024)
Der Kontrollblock für das verschlüsselte Volume wurde von einem anderen Thread aktualisiert.
FVE _ E _ KEY PROTECTOR NOT _ _ _ SUPPORTED
2150695017 (0X80310069)
Die Schlüsselschutzvorrichtung wird von der Version von BitLocker-Laufwerkverschlüsselung derzeit auf dem Volume nicht unterstützt.
FVE _ E _ BS _ VOLUME _ PASSPHRASE _ NOT _ ALLOWED
2150695021 (0x8031006D)
Die Passphrase kann dem Betriebssystemvolume nicht hinzugefügt werden.
FVE _ _E-SCHUTZVORRICHTUNG _ EXISTS
2150694960 (0x80310030)
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
Win32 _ encryptablevolume.mof

Weitere Informationen

Win32 _ EncryptableVolume