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 |
|---|---|
|
Die Methode war erfolgreich. |
|
Das System kann die angegebene Datei nicht erstellen. |
|
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren. |
|
Das Volume kann nicht mit den bereitgestellten Informationen entsperrt werden. |
|
Die bereitgestellte Schlüsselschutzvorrichtung ist auf dem Volume nicht vorhanden. Sie müssen eine andere Schlüsselschutzvorrichtung eingeben. |
|
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 |
|