CIM_TPM 類別的 RequestTPMStateChange 方法
要求 TPM 的狀態變更為 RequestedTPMState 參數中指定的值。 如果方法調用順利完成， TPMState 屬性應該等於 RequestedTPMState 參數。 多次叫用 RequestTPMStateChange 方法可能會導致先前的要求遭到覆寫或遺失。
語法
uint32 RequestTPMStateChange(
[in] uint16 RequestedTPMState,
[in] string AuthorizationToken,
[out] CIM_ConcreteJob REF Job,
[in] datetime TimeoutPeriod
);
參數
-
RequestedTPMState [in]
-
要求的 TPM 狀態。
-
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 保留 (。。)
-
廠商保留 (32768..65535)
AuthorizationToken [in]
可能需要的授權權杖，動作才會生效。 若要建立實體目前狀態，或傳遞 OwnerAuth，可能需要 AuthorizationToken 參數，TCG 定義的擁有者授權密碼。 在 OwnerAuth 的情況下，可能需要CIM_SharedCredential.Secret 的非 Null 值CIM_SharedCredential。 您也可以根據屬性CIM_TPMCapabilities.SupportedPasswordAlgorithms 來指定 CIM_SharedCredential.Algorithm 屬性。
作業 [out]
可能包含所建立 之CIM_ConcreteJob 的參考，以追蹤方法調用所起始的狀態轉換。
TimeoutPeriod [in]
逾時期間，指定用戶端預期轉換至新狀態所花費的時間上限。 間隔格式必須用來指定 TimeoutPeriod。 值為 0 或 null 參數表示用戶端沒有轉換的時間需求。
傳回值
成功時，傳回 0 或 4096;否則，會傳回錯誤。
-
已完成，沒有錯誤 (0)
-
不支援 (1)
-
未知或未指定的錯誤 (2)
-
無法在逾時期間內完成 (3)
-
失敗 (4)
-
不正確參數 (5)
-
在 [使用 (6)
-
DMTF 保留 (。。)
-
已檢查方法參數 - 作業啟動 (4096)
-
不正確狀態轉換 (4097)
-
不支援使用逾時參數 (4098)
-
忙碌 (4099)
-
保留 (4100..32767)
-
廠商特定 (32768..65535)
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 10 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2016 |
| 命名空間 |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|