GetKeyProtectors-Methode der Win32_EncryptableVolume-Klasse

  • Artikel

Die GetKeyProtectors-Methode der Win32_EncryptableVolume-Klasse listet die Schutzvorrichtungen auf, die zum Sichern des Verschlüsselungsschlüssels des Volumes verwendet werden. Wenn ein Schutztyp angegeben wird, werden nur Volumeschlüsselschutze des angegebenen Typs zurückgegeben.

Syntax

uint32 GetKeyProtectors(
  [in, optional] uint32 KeyProtectorType,
  [out]          string VolumeKeyProtectorID[]
);

Parameter

KeyProtectorType [in, optional]

Typ: uint32

Eine ganze Zahl ohne Vorzeichen, die den Typ der zurückzugebenden Schlüsselschutzvorrichtung angibt.

Wenn dieser Parameter nicht angegeben wird, werden alle verfügbaren Schlüsselschutzvorrichtungen des Volumes zurückgegeben.

Wert Bedeutung
0
 Alle Typen.
Alle Schlüsselschutzvorrichtungen werden zurückgegeben.
1
 Trusted Platform Module (TPM).
2
 Externer Schlüssel.
3
 Numerisches Kennwort.
4
 TPM und PIN.
5
 TPM und Startschlüssel.
6
 TPM, PIN und Startschlüssel.
7
 Öffentlicher Schlüssel.
8
 Passphrase.
9
 TPM-Zertifikat
10
 Sicherheitsbezeichner (SID)

 

VolumeKeyProtectorID [out]

Typ: string[]

Ein Array von Zeichenfolgen, das die Schlüsselschutzvorrichtungen identifiziert, die zum Sichern des Verschlüsselungsschlüssels des Volumes verwendet werden.

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.
E_INVALIDARG
2147942487 (0x80070057)
 Der VolumeKeyProtectorID-Parameter wird angegeben, verweist aber nicht auf einen gültigen KeyProtectorType.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker ist auf dem Volume nicht aktiviert. Fügen Sie eine Schlüsselschutzvorrichtung hinzu, um BitLocker zu aktivieren.

 

Bemerkungen

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 Vista Enterprise, Windows Vista Ultimate [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2008 [nur Desktop-Apps]
Namespace
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Weitere Informationen

Win32_EncryptableVolume