UnlockWithCertificateFile-Methode der Win32 _ EncryptableVolume-Klasse

Die UnlockWithCertificateFile-Methode der Win32 _ EncryptableVolume-Klasse verwendet die bereitgestellte Zertifikatdatei, um den abgeleiteten Schlüssel abzurufen und das verschlüsselte Volume zu entsperren.

Hinweis

Wenn der Datenträger Hardwareverschlüsselung unterstützt, legt diese Funktion den Bandstatus auf "entsperrt" fest.

Syntax

uint32 UnlockWithCertificateFile(
  [in] string FileName,
  [in] string PIN
);

Parameter

FileName [ In]

Typ: Zeichenfolge

Eine Zeichenfolge, die den Speicherort und den Namen der CER-Datei angibt, die zum Abrufen des Zertifikatfingerabdrucks verwendet wird. Ein Verschlüsselungszertifikat muss im CER-Format exportiert werden (Distinguished Encoding Rules (DER)-codierte Binärdatei X.509 oder Base-64-codiertes X.509). Das Verschlüsselungszertifikat kann von microsoft-PKI, einer Drittanbieter-PKI oder selbstsigniert generiert werden.

PIN [ In]

Typ: Zeichenfolge

Eine benutzerdefinierte persönliche Identifikationszeichenfolge. Diese Zeichenfolge muss aus einer Sequenz von 4 bis 20 Ziffern bestehen. Diese Zeichenfolge wird verwendet, um den Schlüsselspeicheranbieter (Key Storage Provider, KSP) im Hintergrund zu authentifizieren, wenn er mit einer Smartcardverwendet wird.

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.
FEHLER _ DATEI _ NICHT _ GEFUNDEN
0000000002 (0x2)
Das System kann die angegebene Datei nicht erstellen.
FVE _ E _ NICHT _ AKTIVIERT
2150694920 (0x80310008)
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren.
FVE _ E _ FAILED _ AUTHENTICATION
2150694951 (0x80310027)
Das Volume kann nicht mit den bereitgestellten Informationen entsperrt werden.
FVE _ _E-SCHUTZVORRICHTUNG _ NICHT _ GEFUNDEN
2150694963 (0x80310033)
Die bereitgestellte Schlüsselschutzvorrichtung ist auf dem Volume nicht vorhanden. Sie müssen eine andere Schlüsselschutzvorrichtung eingeben.
FVE _ E _ PRIVATEKEY _ AUTH _ FAILED
2150695060 (0x80310094)
Der private Schlüssel,der dem angegebenen Zertifikat zugeordnet ist, konnte nicht autorisiert werden. Die Autorisierung des privaten Schlüssels wurde entweder nicht bereitgestellt, oder die bereitgestellte Autorisierung war ungültig.

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

Siehe auch

Win32 _ EncryptableVolume