Metodo RequestStateChange della classe CIM_ConcreteJob
Richiede che lo stato del processo venga modificato nel valore specificato nel parametro RequestedState. Richiamando il metodo RequestStateChange più volte, è possibile che le richieste precedenti vengano sovrascritte o perse.
Se viene restituito 0, l'attività è stata completata correttamente. Qualsiasi altro codice restituito indica una condizione di errore.
Sintassi
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
Parametri
-
RequestedState [in]
-
Stato da richiedere per un processo. I valori possibili sono i seguenti:
-
Inizio (2)
-
Modifica lo stato su 'Esecuzione'.
-
Sospensione (3)
-
Arresta temporaneamente il processo. L'intenzione è quella di riavviare successivamente il processo con "Start". Potrebbe essere possibile immettere lo stato "Servizio" durante la sospensione. (Questo è specifico del processo).
-
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 di servizio specifico del fornitore. Potrebbe essere possibile riavviare il processo.
-
DMTF Riservato (7..32767)
-
Fornitore riservato (32768...65535)
TimeoutPeriod [in]
Periodo di timeout che specifica la quantità massima di tempo che il client prevede che la transizione al nuovo stato venga eseguita. Il formato di intervallo deve essere usato per specificare il periodo di timeout. Un valore pari a 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.
-
Completato senza errore (0)
-
Non supportato (1)
-
Errore sconosciuto/non specificato (2)
-
Impossibile completare il periodo di timeout (3)
-
Errore (4)
-
Parametro non valido (5)
-
In Uso (6)
-
DMTF Riservato (..)
-
Parametri del metodo controllati - Transizione avviata (4096)
-
Transizione dello stato non valida (4097)
-
Uso del parametro Timeout non supportato (4098)
-
Occupato (4099)
-
Metodo riservato (4100..32767)
-
Fornitore specifico (32768..65535)
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 8.1 |
| Server minimo supportato |
R2 per Windows Server 2012 |
| Spazio dei nomi |
Radice\virtualizzazione\v2 |
| MOF |
|
| DLL |
|