ChangePIN-Methode der Win32 _ EncryptableVolume-Klasse

Die ChangePIN-Methode der Win32 _ EncryptableVolume-Klasse ändert die PIN, die einem verschlüsselten Volume zugeordnet ist. Wenn die Gruppenrichtlinie "Erweiterte PINs für Start zulassen" aktiviert ist, kann eine PIN zusätzlich zu Zahlen Buchstaben, Symbole und Leerzeichen enthalten.

Syntax

uint32 ChangePIN(
  [in] string VolumeKeyProtectorID,
  [in] string NewPIN
);

Parameter

VolumeKeyProtectorID [ In]

Typ: Zeichenfolge

Der eindeutige Zeichenfolgenbezeichner, der zum Verwalten einer verschlüsselten Volumeschlüsselschutzvorrichtung verwendet wird.

NewPIN [ In]

Typ: Zeichenfolge

Eine benutzerdefinierte persönliche Identifikationszeichenfolge. Diese Zeichenfolge muss aus einer Sequenz von 4 bis 20 Ziffern bestehen, oder, wenn die Gruppenrichtlinie "Erweiterte PINs für Start zulassen" aktiviert ist, 4 bis 20 Buchstaben, Symbole, Leerzeichen oder Zahlen.

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 _ BOOTABLE _ CDDVD
2150694960 (0x80310030)
Auf diesem Computer befindet sich eine startbare CD/DVD. Entfernen Sie die CD/DVD, und starten Sie den Computer neu.
FVE _ E _ UNGÜLTIGE _ _ PIN-2150695066
(0x8031009A)
Der NewPIN-Parameter enthält ungültige Zeichen. Wenn die Gruppenrichtlinie "Erweiterte PINs für Start zulassen" deaktiviert ist, werden nur Zahlen unterstützt.
FVE _ E _ _ UNGÜLTIGER _ SCHUTZVORRICHTUNGSTYP
2150694970 (0x8031003A)
Der Parameter VolumeKeyProtectorID verweist nicht auf eine Schlüsselschutzvorrichtung vom Typ "Numerisches Kennwort" oder "Externer Schlüssel". Verwenden Sie entweder die ProtectKeyWithNumericalPassword-Methode oder die ProtectKeyWithExternalKey-Methode, um eine Schlüsselschutzvorrichtung des entsprechenden Typs zu erstellen.
FVE _ E _ LOCKED _ VOLUME
2150694912 (0x80310000)
Das Volume ist gesperrt.
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 _ POLICY INVALID PIN _ _ _ LENGTH
2150695016 (0x80310068)
Der angegebene NewPIN-Parameter ist entweder länger als 20 Zeichen, kürzer als 4 Zeichen oder kürzer als die durch Gruppenrichtlinie angegebene Mindestlänge.
FVE _ _E-SCHUTZVORRICHTUNG _ NICHT GEFUNDEN _ 2150694963
(0x80310033)
Die bereitgestellte Schlüsselschutzvorrichtung ist auf dem Volume nicht vorhanden.
TBS _ _E-DIENST _ WIRD NICHT _ AUSGEFÜHRT
2150121480 (0x80284008)
Auf diesem Computer wurde kein kompatibles Trusted Platform Module (TPM) gefunden.

Hinweise

Die ChangePIN-Methode erstellt eine neue TPM- und PIN-Schutzvorrichtung basierend auf den vorhandenen Schutzvorrichtungsinformationen und der neu bereitgestellten PIN. Die neue Schutzvorrichtung hat die gleiche GUID. Die ChangePIN-Methode kann auch aufgerufen werden, um die PIN jeder Schlüsselschutzvorrichtung zu ändern, die eine PIN verwendet, z. B. TPM und PIN oder TPM mit PIN und USB.

Managed Object Format -Dateien (MOF) enthalten die Definitionen für Windows Management Instrumentation (WMI)-Klassen. MOF-Dateien werden nicht als Teil des Windows SDK installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe der Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

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