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 |
|---|---|
|
Die Methode war erfolgreich. |
|
Auf diesem Computer befindet sich eine startbare CD/DVD. Entfernen Sie die CD/DVD, und starten Sie den Computer neu. |
|
Der NewPIN-Parameter enthält ungültige Zeichen. Wenn die Gruppenrichtlinie "Erweiterte PINs für Start zulassen" deaktiviert ist, werden nur Zahlen unterstützt. |
|
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. |
|
Das Volume ist gesperrt. |
|
BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren. |
|
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. |
|
Die bereitgestellte Schlüsselschutzvorrichtung ist auf dem Volume nicht vorhanden. |
|
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 |
|