RequestTPMStateChange-Methode der CIM_TPM-Klasse
Fordert an, dass der Zustand des TPM in den im RequestedTPMState-Parameter angegebenen Wert geändert wird. Wenn der Methodenaufruf erfolgreich abgeschlossen wird, muss die TPMState-Eigenschaft gleich dem RequestedTPMState-Parameter sein. Das mehrfache Aufrufen der RequestTPMStateChange-Methode kann dazu führen, dass frühere Anforderungen überschrieben werden oder verloren gehen.
Syntax
uint32 RequestTPMStateChange(
[in] uint16 RequestedTPMState,
[in] string AuthorizationToken,
[out] CIM_ConcreteJob REF Job,
[in] datetime TimeoutPeriod
);
Parameter
-
RequestedTPMState [in]
-
Die angeforderten TPM-Zustände.
-
S1 Enabled-Active-Owned (2)
-
S2 Disabled-Active-Owned (3)
-
S3 Enabled-Inactive-Owned (4)
-
S4 Disabled-Inactive-Owned (5)
-
S5 Enabled-Active-Unowned (6)
-
S6 Disabled-Active-Unowned (7)
-
S7 Enabled-Inactive-Unowned (8)
-
S8 Disabled-Inactive-Unowned (9)
-
DMTF Reserviert (..)
-
Anbieter reserviert (32768..65535)
AuthorizationToken [in]
Autorisierungstoken, das möglicherweise erforderlich ist, damit die Aktion wirksam wird. Der AuthorizationToken-Parameter kann erforderlich sein, um physische Anwesenheit einzurichten oder um ownerAuth, das vom TCG definierte Autorisierungskennwort des Besitzers, zu übergeben. Im Fall von OwnerAuth kann die CIM_SharedCredential mit dem Wert ungleich NULL des CIM_SharedCredential.Secret erforderlich sein. Die CIM_SharedCredential.Algorithm-Eigenschaft kann auch basierend auf der Eigenschaft CIM_TPMCapabilities.SupportedPasswordAlgorithms angegeben werden.
Auftrag [out]
Kann einen Verweis auf die CIM_ConcreteJob enthalten, die erstellt wurde, um den durch den Methodenaufruf initiierten Zustandsübergang nachzuverfolgen.
TimeoutPeriod [in]
Ein Timeoutzeitraum, der die maximale Zeitspanne angibt, die der Client für den Übergang in den neuen Zustand erwartet. Das Intervallformat muss verwendet werden, um timeoutPeriod anzugeben. Der Wert 0 oder ein NULL-Parameter gibt an, dass der Client keine Zeitanforderungen für den Übergang hat.
Rückgabewert
Gibt bei Erfolg eine 0 oder 4096 zurück. Gibt andernfalls einen Fehler zurück.
-
Abgeschlossen ohne Fehler (0)
-
Nicht unterstützt (1)
-
Unbekannter oder nicht angegebener Fehler (2)
-
Innerhalb des Timeoutzeitraums kann nicht abgeschlossen werden (3)
-
Fehler (4)
-
Ungültiger Parameter (5)
-
In Verwendung (6)
-
DMTF Reserviert (..)
-
Methodenparameter überprüft – Auftrag gestartet (4096)
-
Ungültiger Zustandsübergang (4097)
-
Verwendung des Timeoutparameters wird nicht unterstützt (4098)
-
Busy (4099)
-
Reservierte Methode (4100..32767)
-
Herstellerspezifisch (32768..65535)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2016 |
| Namespace |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|