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]
アクションを有効にするために必要な承認トークン。 Physical Presence を確立したり、OwnerAuth を渡したりするために、TCG で定義された所有者承認パスワードを渡すために、 AuthorizationToken パラメーターが必要になる場合があります。 OwnerAuth の場合、CIM_SharedCredential.Secret の null 以外の値を持つCIM_SharedCredentialが必要になる場合があります。 CIM_SharedCredential.Algorithm プロパティは、プロパティ CIM_TPMCapabilities.SupportedPasswordAlgorithms に基づいて指定することもできます。
ジョブ [出力]
メソッド呼び出しによって開始された状態遷移を追跡するために作成された CIM_ConcreteJob への参照を含めることができます。
TimeoutPeriod [in]
クライアントが新しい状態への移行にかかる最大時間を指定するタイムアウト期間。 TimeoutPeriod を指定するには、間隔形式を使用する必要があります。 値 0 または null パラメーターは、クライアントに遷移の時間要件がないことを示します。
戻り値
成功した場合、 は 0 または 4096 を返します。それ以外の場合は、エラーを返します。
-
エラーなしで完了 しました (0)
-
サポートされていません (1)
-
不明または未指定のエラー (2)
-
タイムアウト期間内に完了できません (3)
-
失敗 ( 4)
-
無効なパラメーター (5)
-
使用中 (6)
-
DMTF 予約済み (...)
-
チェックされたメソッド パラメーター - ジョブの開始 (4096)
-
無効な状態遷移 (4097)
-
タイムアウト パラメーターの使用はサポートされていません (4098)
-
Busy (4099)
-
メソッド予約済み (4100..32767)
-
ベンダー固有 (32768..65535)
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 10 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2016 |
| 名前空間 |
Root\virtualization\v2 |
| MOF |
|
| [DLL] |
|