Msvm_CopyFileToGuestJob::RequestStateChange メソッド
ジョブの状態を変更します。
構文
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
パラメーター
-
RequestedState [in]
-
新しい状態です。 次の値を使用できます。
-
開始 (2)
-
状態を "実行中" に変更します。
-
中断 (3)
-
ジョブを一時的に停止します。 その後、クライアントは 'Start' を使用してジョブを再起動できます。 クライアントは、中断中に "サービス" 状態に入る可能性があります (これはジョブ固有です)。
-
Terminate (4)
-
ジョブをクリーンに停止し、データを保存し、状態を維持し、基になるすべてのプロセスを順番にシャットダウンします。
-
Kill (5)
-
データを保存したり、状態を保持したりする必要なく、ジョブを直ちに終了します。
-
サービス (6)
-
ジョブをベンダー固有のサービス状態にします。 クライアントは、ジョブを再起動できる可能性があります。
-
DMTF 予約済み (7..32767)
-
ベンダー予約済み (32768..65535)
TimeoutPeriod [in]
クライアントが新しい状態への移行にかかる最大時間を指定するタイムアウト期間。 タイムアウト期間を指定するには、間隔形式を使用する必要があります。 0 または Null の 値は、クライアントに移行の時間要件がないことを示します。 このプロパティに 0 または Null が含まれていない場合、実装でこのパラメーターがサポートされていない場合は、戻りコード 4098 (サポートされていないタイムアウト パラメーターの使用) を返す必要があります。
戻り値
このメソッドは、次のいずれかの値を返します。
リターン コード/値 | 説明 |
---|---|
|
正常終了しました。 |
|
|
|
|
|
アクセスが拒否されました。 |
|
|
|
|
|
|
|
|
|
|
|
RequestedState パラメーターで指定された値はサポートされていません。 |
|
|
|
|
|
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 8.1 [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2012 R2 [デスクトップ アプリのみ] |
名前空間 |
\\Root\Virtualization\V2 |
MOF |
|
[DLL] |
|