ChangePIN-Methode der Win32_EncryptableVolume-Klasse

  • Artikel

Die ChangePIN-Methode der Win32_EncryptableVolume-Klasse ändert die PIN, die einem verschlüsselten Volume zugeordnet ist. Wenn die Gruppenrichtlinie "Erweiterte PINs für den 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 vom Benutzer angegebene persönliche Identifikationszeichenfolge. Diese Zeichenfolge muss aus einer Sequenz von 4 bis 20 Ziffern oder, wenn die Gruppenrichtlinie "Erweiterte PINs für den Start zulassen" aktiviert ist, aus 4 bis 20 Buchstaben, Symbolen, Leerzeichen oder Zahlen bestehen.

Rückgabewert

Typ: uint32

Diese Methode gibt einen der folgenden Codes oder einen anderen Fehlercode zurück, wenn ein Fehler auftritt.

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_INVALID_PIN_CHARS
2150695066 (0x8031009A)
 Der NewPIN-Parameter enthält ungültige Zeichen. Wenn die Gruppenrichtlinie "Erweiterte PINs für den Start zulassen" deaktiviert ist, werden nur Zahlen unterstützt.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 Der Parameter VolumeKeyProtectorID verweist nicht auf einen Schlüsselschutz vom Typ "Numerisches Kennwort" oder "Externer Schlüssel". Verwenden Sie entweder die Methode ProtectKeyWithNumericalPassword oder ProtectKeyWithExternalKey , um eine Schlüsselschutzvorrichtung des entsprechenden Typs zu erstellen.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Das Volume ist gesperrt.
FVE_E_NOT_ACTIVATED
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_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 Die angegebene Schlüsselschutzvorrichtung ist auf dem Volume nicht vorhanden.
TBS_E_SERVICE_NOT_RUNNING
2150121480 (0x80284008)
 Auf diesem Computer ist kein kompatibles Trusted Platform Module (TPM) vorhanden.

 

Bemerkungen

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

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 7 Enterprise, Windows 7 Ultimate [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2008 R2 [nur Desktop-Apps]
Namespace
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Siehe auch

Win32_EncryptableVolume