A CIM_LANEndpoint osztály RequestStateChange metódusa
Kéri, hogy az elem állapota a RequestedState paraméterben megadott értékre módosuljon. Amikor a kért állapotváltozás megtörténik, az elem EnabledState és RequestedState állapota megegyezik. A RequestChangeState metódus többszöri meghívása a korábbi kérések felülírását vagy elvesztését eredményezheti. Ha 0 értéket ad vissza, akkor a feladat sikeresen befejeződött, és nem volt szükség a ConcreteJob használatára. Ha a 4096 -ot (0x1000) adja vissza, akkor a feladat végrehajtása némi időt vesz igénybe, létrejön a ConcreteJob, és a feladat kimeneti paraméterében visszaadott hivatkozás. Bármely más visszatérési kód hibafeltételt jelez.
Szintaxis
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob Job,
[in] datetime TimeoutPeriod
);
Paraméterek
-
RequestedState [in]
-
Az elemhez kért állapot. Ezek az információk akkor kerülnek a példány RequestedState tulajdonságába, ha a RequestStateChange metódus visszatérési kódja 0 ("Hiba nélkül befejezve"), 3 (időtúllépés) vagy 4096 (0x1000) ('Job Started'). A RequestedState értékek részletes magyarázatáért tekintse meg az EnabledState és a RequestedState tulajdonságok leírását.
-
Engedélyezett (2)
-
Letiltott (3)
-
leállítása (4)
-
offline (6)
-
tesztelési (7)
-
halasztás (8)
-
Quiesce (9)
-
újraindítási (10)
-
alaphelyzetbe állítása (11)
-
fenntartott DMTF- (12 32767)
-
Szállító fenntartott (32768 65535)
-
-
feladat [ki]
-
Egy CIM_ConcreteJob, amely a feladatra mutató hivatkozást tartalmaz (null értékű lehet, ha a tevékenység befejeződött).
-
TimeoutPeriod [in]
-
Időtúllépési időszak, amely meghatározza az ügyfél által az új állapotra való áttérés várható maximális időtartamát. Az időtartam megadásához az intervallumformátumot kell használni. A 0 vagy null paraméter értéke azt jelzi, hogy az ügyfélnek nincs időkövetelménye az áttűnéshez. Ha ez a tulajdonság nem tartalmaz 0 vagy null értéket, és az implementáció nem támogatja ezt a paramétert, akkor az "Időtúllépési paraméter használata nem támogatott" visszatérési kódot kell visszaadni.
Visszaadott érték
-
Hiba nélkül befejezve (0)
-
nem támogatott (1)
-
Ismeretlen vagy meghatározatlan hiba (2)
-
Időtúllépési időszakon belül nem fejezhető be (3)
-
sikertelen (4)
-
érvénytelen paraméter (5)
-
Használatban (6)
-
DMTF fenntartott (7 4095)
-
metódusparaméterek bejelölve – A feladat (4096)
-
Érvénytelen állapotváltási (4097)
-
Időtúllépési paraméter használata nem támogatott (4098)
-
Foglalt (4099)
-
metódus fenntartott (4100 32767)
-
Szállítóspecifikus (32768 65535)
Követelmények
| Minimálisan támogatott ügyfél |
Windows 8 |
| Minimálisan támogatott kiszolgáló |
Windows Server 2012 |
| Namespace |
Root\standardcimv2 |
| MOF |
|
| DLL |
|