Metode RequestStateChange dari kelas CIM_ConcreteJob

Meminta agar status pekerjaan diubah ke nilai yang ditentukan dalam parameter RequestedState. Memanggil metode RequestStateChange beberapa kali dapat mengakibatkan permintaan sebelumnya ditimpa atau hilang.

Jika 0 dikembalikan, maka tugas berhasil diselesaikan. Kode pengembalian lainnya menunjukkan kondisi kesalahan.

Sintaks

uint32 RequestStateChange(
  [in] uint16   RequestedState,
  [in] datetime TimeoutPeriod
);

Parameter

RequestedState [in]

Status untuk meminta pekerjaan. Nilai yang mungkin adalah sebagai berikut:

Mulai (2)

Mengubah status menjadi 'Berjalan'.

Tangguhkan (3)

Menghentikan pekerjaan sementara. Tujuannya adalah untuk memulai ulang pekerjaan dengan 'Mulai'. Mungkin untuk memasuki status 'Layanan' saat ditangguhkan. (Ini khusus untuk pekerjaan.)

Hentikan (4)

Menghentikan pekerjaan dengan bersih, menyimpan data, mempertahankan status, dan mematikan semua proses yang mendasarinya dengan tertib.

Matikan (5)

Segera mengakhiri pekerjaan tanpa persyaratan untuk menyimpan data atau mempertahankan status.

Layanan (6)

Menempatkan pekerjaan ke dalam status layanan khusus vendor. Mungkin dimungkinkan untuk memulai ulang pekerjaan.

DMTF Dicadangkan (7..32767)

Vendor Khusus (32768..65535)

TimeoutPeriod [in]

Periode batas waktu yang menentukan jumlah waktu maksimum yang diharapkan klien untuk transisi ke status baru. Format interval harus digunakan untuk menentukan periode waktu habis. Nilai 0 atau Null menunjukkan bahwa klien tidak memiliki persyaratan waktu untuk transisi. Jika properti ini tidak berisi 0 atau Null dan implementasi tidak mendukung parameter ini, kode pengembalian 4098 (Penggunaan Parameter Batas Waktu Tidak Didukung) harus dikembalikan.

Mengembalikan nilai

Mengembalikan 0 pada keberhasilan; jika tidak, mengembalikan kesalahan.

Selesai tanpa Kesalahan (0)

Tidak Didukung (1)

Kesalahan Tidak Diketahui/Tidak Ditentukan (2)

TIDAK dapat diselesaikan dalam Periode Waktu Habis (3)

Gagal (4)

Parameter Tidak Valid (5)

Sedang Digunakan (6)

DMTF Dicadangkan (..)

Parameter Metode Diperiksa - Transisi Dimulai (4096)

Transisi Status Tidak Valid (4097)

Penggunaan Parameter Batas Waktu Tidak Didukung (4098)

Sibuk (4099)

Metode Khusus (4100..32767)

Spesifikasi Vendor (32768..65535)

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows 8.1
Server minimum yang didukung
Windows Server 2012 R2
Ruang nama
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Lihat juga

CIM_ConcreteJob