Disable-Methode der Win32_Tpm-Klasse

Artikel
06/13/2023

Die Disable-Methode der Win32_Tpm-Klasse ermöglicht es dem TPM-Besitzer, das TPM zu deaktivieren oder anzusetzen. Diese Methode hält BitLocker an, wenn ein Aufruf dazu führen kann, dass eine BitLocker-Wiederherstellung erforderlich ist. BitLocker würde automatisch fortgesetzt, sobald TPM bereitgestellt wurde.

Syntax

uint32 Disable(
  [in, optional] string OwnerAuth
);

Parameter

OwnerAuth [in, optional]

Typ: Zeichenfolge

Eine Zeichenfolge, die den TPM-Besitzer identifiziert. Diese Zeichenfolge muss eine Base64-codierte Zeichenfolge sein, die genau 20 Byte binärdaten enthält. Verwenden Sie die ConvertToOwnerAuth-Methode , um eine Passphrase in dieses erwartete Format zu übersetzen. Der OwnerAuth-Parameter wird aus der Registrierung gelesen, wenn keiner angegeben wird.

Rückgabewert

Typ: uint32

Alle TPM-Fehler sowie fehlerspezifisch für TPM-Basisdienste können zurückgegeben werden.

In der folgenden Tabelle sind einige der allgemeinen Rückgabecodes aufgeführt.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0 (0x0)	Die Methode war erfolgreich.
TPM_E_AUTHFAIL 2150105089 (0x80280001)	Der angegebene Autorisierungswert des Besitzers kann die Anforderung nicht ausführen.
TPM_E_DEFEND_LOCK_RUNNING 2150107139 (0x80280803)	Das TPM schützt vor Wörterbuchangriffen und befindet sich in einem Timeout. Weitere Informationen finden Sie unter der ResetAuthLockOut-Methode .

Bemerkungen

Verwenden Sie die SetPhysicalPresenceRequest-Methode , um das TPM zu deaktivieren, ohne über den Autorisierungswert des TPM-Besitzers zu verfügen.

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 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Namespace	Root\CIMV2\Security\MicrosoftTpm
MOF	Win32_tpm.mof
DLL	Win32_tpm.dll

Weitere Informationen

Win32_Tpm
SetPhysicalPresenceRequest

Share via