Metode RequestStateChange dari kelas MSFT_NetBaseIPProtocol
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 RequestChangeState beberapa kali dapat mengakibatkan permintaan sebelumnya ditimpa atau hilang. Jika 0 dikembalikan, maka tugas berhasil diselesaikan dan penggunaan ConcreteJob tidak diperlukan. Jika 4096 (0x1000) dikembalikan, maka tugas akan memakan waktu untuk diselesaikan, ConcreteJob akan dibuat, dan referensinya dikembalikan dalam parameter output Pekerjaan. Kode pengembalian lainnya menunjukkan kondisi kesalahan.
Sintaksis
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob 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'), 3 ('Waktu Habis'), atau 4096 (0x1000) ('Pekerjaan Dimulai'). Lihat deskripsi properti EnabledState dan RequestedState untuk penjelasan terperinci tentang nilai RequestedState.
-
Diaktifkan (2)
-
Dinonaktifkan (3)
-
Matikan (4)
-
Offline (6)
-
Test (7)
-
Tunggu (8)
-
Quiesce (9)
-
Reboot (10)
-
Reset (11)
-
DMTF Reserved (12 32767)
-
Cadangan Vendor (32768 65535)
-
-
Job [out]
-
CIM_ConcreteJob yang berisi referensi ke pekerjaan (bisa null jika tugas selesai).
-
TimeoutPeriod [in]
-
Periode waktu habis yang menentukan jumlah waktu maksimum yang diharapkan klien untuk transisi ke status baru. Format interval harus digunakan untuk menentukan periode ini. Nilai 0 atau parameter 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 'Penggunaan Parameter Batas Waktu Tidak Didukung' harus dikembalikan.
Mengembalikan nilai
-
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)
-
Yang Digunakan (6)
-
DMTF Reserved (7 4095)
-
Parameter Metode Diperiksa - Pekerjaan Dimulai (4096)
-
Transisi Status tidak valid (4097)
-
Penggunaan Parameter Batas Waktu Tidak Didukung (4098)
-
Sibuk (4099)
-
Cadangan Metode (4100 32767)
-
Spesifik Vendor (32768 65535)
Persyaratan
| Klien minimum yang didukung |
Windows 8 |
| Server minimum yang didukung |
Windows Server 2012 |
| Namespace layanan |
Root\standardcimv2 |
| MOF |
|
| DLL |
|