Metode RequestStateChange dari kelas CIM_EnabledLogicalElement

Meminta agar status elemen diubah ke nilai yang ditentukan dalam parameter RequestedState. Ketika perubahan status yang diminta terjadi, EnabledState dan RequestedState elemen akan sama. Memanggil metode RequestStateChange beberapa kali dapat mengakibatkan permintaan sebelumnya ditimpa atau hilang.

Sintaks

uint32 RequestStateChange(
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob REF Job,
  [in]  datetime            TimeoutPeriod
);

Parameter

RequestedState [in]

Status yang diminta untuk elemen . Informasi ini akan ditempatkan ke properti RequestedState instans jika kode pengembalian metode RequestStateChange adalah 0 ('Selesai tanpa Kesalahan'), atau 4096 (0x1000) ('Pekerjaan Dimulai'). Lihat deskripsi properti EnabledState dan RequestedState untuk penjelasan terperinci tentang nilai RequestedState .

Mulai (2)

Mengubah status menjadi 'Berjalan'.

Tangguhkan (3)

Menghentikan pekerjaan sementara. Tujuannya adalah untuk kemudian memulai ulang pekerjaan dengan 'Mulai'. Dimungkinkan untuk memasukkan 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)

Mengakhiri pekerjaan segera tanpa persyaratan untuk menyimpan data atau mempertahankan status.

Layanan (6)

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

DMTF Dicadangkan (7..32767)

Vendor Khusus (32768..65535)

Job [out]

Mungkin berisi referensi ke CIM_ConcreteJob yang dibuat untuk melacak transisi status yang dimulai oleh pemanggilan metode.

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 batas waktu. 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.

Menampilkan nilai

Mengembalikan 0 pada keberhasilan; jika tidak, mengembalikan kesalahan.

Selesai tanpa Kesalahan (0)

Tidak Didukung (1)

Kesalahan Tidak Diketahui atau 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 - Pekerjaan Dimulai (4096)

Transisi Status Tidak Valid (4097)

Penggunaan Parameter Batas Waktu Tidak Didukung (4098)

Sibuk (4099)

Metode Reserved (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_EnabledLogicalElement