metodo Msvm_GuestService::RequestStateChange

Articolo
06/13/2023

Richiede che lo stato del servizio guest venga modificato nel valore specificato.

Sintassi

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

Parametri

RequestedState [in]: Nuovo stato. Le informazioni vengono inserite nella proprietà RequestedState dell'istanza se il codice restituito del metodo RequestStateChange è 0 o 4096. Per altre info, vedi la descrizione delle proprietà EnabledState e RequestedState per l'elemento. Deve essere uno dei valori seguenti.
Abilitato (2)
Disabilitato (3)
Arresto (4)
Offline (6)
Test (7)
Rinvio (8)
Quiesce (9)
Riavvio (10)
Reimpostazione (11)
DMTF Riservato (..)
Fornitore riservato (32768...65535)

Processo [out]

Riferimento facoltativo a un oggetto CIM_ConcreteJob restituito se l'operazione viene eseguita in modo asincrono. Se presente, il riferimento restituito può essere usato per monitorare lo stato di avanzamento e ottenere il risultato del 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

Questo metodo restituisce uno dei valori seguenti.

Codice/valore restituito	Descrizione
Completata senza errori 0	Esito positivo.
Non supportato 1
Parametri del metodo controllati - Transizione avviata 4096	La transizione è asincrona.
Uso del parametro timeout non supportato 4098
Accesso negato 32769	Accesso negato.
Stato non valido per questa operazione 32775	Il valore specificato nel parametro RequestedState non è supportato.

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_GuestService

Condividi tramite