ChangePassphrase-Methode der Win32_EncryptableVolume-Klasse

  • Artikel

Die ChangePassphrase-Methode der Win32_EncryptableVolume-Klasse verwendet die neue Passphrase, um einen neuen abgeleiteten Schlüssel abzurufen. Nachdem der abgeleitete Schlüssel berechnet wurde, wird der neue abgeleitete Schlüssel verwendet, um den master Schlüssel des verschlüsselten Volumes zu sichern.

Syntax

uint32 ChangePassphrase(
  [in]  string VolumeKeyProtectorID,
  [in]  string NewPassphrase,
  [out] string NewProtectorID
);

Parameter

VolumeKeyProtectorID [in]

Typ: Zeichenfolge

Ein eindeutiger Zeichenfolgenbezeichner, der zum Verwalten einer verschlüsselten Volumeschlüsselschutzvorrichtung verwendet wird.

NewPassphrase [in]

Typ: Zeichenfolge

Eine aktualisierte Zeichenfolge, die die Passphrase angibt.

NewProtectorID [out]

Typ: Zeichenfolge

Ein aktualisierter eindeutiger Zeichenfolgenbezeichner, der zum Verwalten einer verschlüsselten Volumeschlüsselschutzvorrichtung verwendet wird.

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_LOCKED_VOLUME
2150694912 (0x80310000)
 Das Volume ist bereits durch die BitLocker-Laufwerkverschlüsselung gesperrt. Sie müssen das Laufwerk von Systemsteuerung entsperren.
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_OVERLAPPED_UPDATE
2150694948 (0x80310024)
 Der Kontrollblock für das verschlüsselte Volume wurde von einem anderen Thread aktualisiert.
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 Die angegebene Schlüsselschutzvorrichtung hat nicht den richtigen Typ.
FVE_E_POLICY_INVALID_PASSPHRASE_LENGTH
2150695040 (0x80310080)
 Die angegebene aktualisierte Passphrase erfüllt nicht die Mindest- oder Maximallängenanforderungen.
FVE_E_POLICY_PASSPHRASE_TOO_SIMPLE
2150695041 (0x80310081)
 Die aktualisierte Passphrase erfüllt nicht die vom Administrator in der Gruppenrichtlinie festgelegten Komplexitätsanforderungen.

 

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

Weitere Informationen

Win32_EncryptableVolume