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	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Vedi anche

CIM_ConcreteJob