Condividi tramite


metodo Msvm_CopyFileToGuestJob::RequestStateChange

Modifica lo stato del processo.

Sintassi

uint32 RequestStateChange(
  [in] uint16   RequestedState,
  [in] datetime TimeoutPeriod
);

Parametri

RequestedState [in]

Nuovo stato. Questi sono i valori possibili:

Inizio (2)

Modifica lo stato in "In esecuzione".

Sospensione (3)

Arresta temporaneamente il processo. Il client può quindi riavviare il processo con "Start". Il client può eventualmente entrare nello stato "Servizio" durante la sospensione (questo è specifico del processo).

Termina (4)

Arresta il processo in modo pulito, salvando i dati, mantenendo lo stato e arrestando 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. Il client può eventualmente riavviare il processo.

DMTF Riservato (7..32767)

Fornitore riservato (32768...65535)

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

Questo metodo restituisce uno dei valori seguenti.

Codice/valore restituito Descrizione
Completata senza errori
0
Esito positivo.
Uso del parametro timeout non supportato
4098
Operazione non riuscita
32768
Accesso negato
32769
Accesso negato.
Non supportato
32770
Lo stato è sconosciuto
32771
Timeout
32772
Parametro non valido
32773
Il sistema è in uso
32774
Stato non valido per questa operazione
32775
Il valore specificato nel parametro RequestedState non è supportato.
Tipo di dati non corretto
32776
Sistema non disponibile
32777
Memoria insufficiente
32778

Requisiti

Requisito Valore
Client minimo supportato
Windows 8.1 [solo app desktop]
Server minimo supportato
Windows Server 2012 R2 [solo app desktop]
Spazio dei nomi
\\Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Vedi anche

Msvm_CopyFileToGuestJob