CIM_EnabledLogicalElement WMI sınıfının RequestStateChange yöntemi

öğesinin durumunun RequestedState parametresinde belirtilen değere değiştirilmesini istemektedir. İstenen durum değişikliği gerçekleştiğinde, öğenin EnabledState ve RequestedState değeri aynı olur. RequestChangeState yönteminin birden çok kez çağrılması, önceki isteklerin üzerine yazılması veya kaybolmasına neden olabilir. 0 döndürülürse, görev başarıyla tamamlanır ve ConcreteJob kullanımı gerekli değildir. 4096 (0x1000) döndürülürse, görevin tamamlanması biraz zaman alır, ConcreteJob oluşturulur ve başvurusu İş çıkış parametresinde döndürülür. Diğer dönüş kodları bir hata koşulu gösterir.

Sözdizimi

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

Parametre

RequestedState [in]

öğe için istenen durum. RequestStateChange yönteminin dönüş kodu 0 ('Hata Olmadan Tamamlandı'), 3 ('Timeout') veya 4096 (0x1000) ('İş Başlatıldı') ise bu bilgiler örneğin RequestedState özelliğine yerleştirilir. RequestedState değerlerinin ayrıntılı açıklamaları için EnabledState ve RequestedState özelliklerinin açıklamasına bakın.

Etkin (2)

Devre Dışı (3)

Kapatma (4)

çevrimdışı (6)

Test (7)

Erteleme (8)

Quiesce (9)

Yeniden Başlatma (10)

Sıfırlama (11)

DMTF Ayrılmış (12 32767)

Satıcı Ayrılmış (32768 65535)

İş [out]

İşe başvuru içeren bir CIM_ConcreteJob (görev tamamlandığında null olabilir).

TimeoutPeriod [in]

İstemcinin yeni duruma geçişin geçmesi için bekleyeceği en uzun süreyi belirten zaman aşımı süresi. Bu dönemi belirtmek için aralık biçimi kullanılmalıdır. 0 veya null parametre değeri, istemcinin geçiş için zaman gereksinimi olmadığını gösterir. Bu özellik 0 veya null içermiyorsa ve uygulama bu parametreyi desteklemiyorsa, 'Use Of Timeout Parameter Not Supported' dönüş kodu döndürülmelidir.

Dönüş değeri

Hatasız Tamamlandı (0)

Desteklenmiyor (1)

Bilinmeyen veya Belirtilmeyen Hata (2)

Zaman Aşımı Süresi içinde tamamlanamıyor (3)

Başarısız (4)

Geçersiz Parametre (5)

Kullanımda (6)

DMTF Ayrılmış (7 4095)

Yöntem Parametreleri İşaretlendi - İş Başlatıldı (4096)

Geçersiz Durum Geçişi (4097)

Zaman Aşımı Parametresinin Kullanımı Desteklenmiyor (4098)

Meşgul (4099)

Yöntemi Ayrılmış (4100 32767)

Satıcıya Özel (32768 65535)

Gereksinim -leri

Gereksinim	Değer
Desteklenen en düşük istemci	Windows 8
Desteklenen en düşük sunucu	Windows Server 2012
Namespace	Root\standardcimv2
MOF	NetTCPIP.mof
DLL	NetTCPIP.dll

Ayrıca bkz.

CIM_EnabledLogicalElement