Metodo RequestStateChange della classe CIM_EnabledLogicalElement
Richiede che lo stato dell'elemento venga modificato nel valore specificato nel parametro RequestedState. Quando viene apportata la modifica dello stato richiesta, EnabledState e RequestedState dell'elemento saranno uguali. Richiamare il metodo RequestStateChange più volte potrebbe comportare la sovrascrittura o la perdita di richieste precedenti.
Sintassi
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob REF Job,
[in] datetime TimeoutPeriod
);
Parametri
-
RequestedState [in]
-
Stato richiesto per l'elemento. Queste informazioni verranno inserite nella proprietà RequestedState dell'istanza se il codice restituito del metodo RequestStateChange è 0 ('Completed with No Error') o 4096 (0x1000) ('Job Started'). Per le spiegazioni dettagliate dei valori RequestedState, vedere la descrizione delle proprietà EnabledState e RequestedState.
-
Inizio (2)
-
Modifica lo stato in "In esecuzione".
-
Sospensione (3)
-
Arresta temporaneamente il processo. L'intenzione è riavviare successivamente il processo con "Start". Potrebbe essere possibile entrare nello stato "Servizio" durante la sospensione. Si tratta di un processo specifico.
-
Termina (4)
-
Arresta il processo in modo pulito, salva i dati, mantiene lo stato e arresta tutti i processi sottostanti in modo ordinato.
-
Uccidere (5)
-
Termina immediatamente il processo senza alcun requisito per salvare i dati o mantenere lo stato.
-
Servizio (6)
-
Inserisce il processo in uno stato del servizio specifico del fornitore. Potrebbe essere possibile riavviare il processo.
-
DMTF Riservato (7..32767)
-
Fornitore riservato (32768...65535)
Processo [out]
Può contenere un riferimento al CIM_ConcreteJob creato per tenere traccia della transizione di stato avviata dalla chiamata al metodo.
TimeoutPeriod [in]
Periodo di timeout che specifica la quantità massima di tempo prevista dal client per la transizione al nuovo stato. Il formato intervallo deve essere utilizzato per specificare il periodo di timeout. Il valore 0 o Null indica che il client non ha requisiti di tempo per la transizione. Se questa proprietà non contiene 0 o Null e l'implementazione non supporta questo parametro, deve essere restituito un codice restituito di 4098 (utilizzo del parametro timeout non supportato).
Valore restituito
Restituisce un valore 0 in caso di esito positivo; in caso contrario, restituisce un errore.
-
Completata senza errore (0)
-
Non supportato (1)
-
Errore sconosciuto o non specificato (2)
-
Impossibile completare entro il periodo di timeout (3)
-
Non riuscito (4)
-
Parametro non valido (5)
-
In uso (6)
-
DMTF Riservato (..)
-
Parametri del metodo controllati - Processo avviato (4096)
-
Transizione di stato non valida (4097)
-
Uso del parametro timeout non supportato (4098)
-
Occupato (4099)
-
Metodo riservato (4100..32767)
-
Specifica del fornitore (32768..65535)
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 8.1 |
| Server minimo supportato |
R2 per Windows Server 2012 |
| Spazio dei nomi |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|