metodo Msvm_GuestServiceInterfaceComponent::RequestStateChange

Richiede che lo stato del componente dell'interfaccia del servizio guest venga modificato nel valore specificato.

Sintassi

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

Parametri

RequestedState [in]

Tipo: uint16

Nuovo stato. Le informazioni vengono inserite nella proprietà RequestedState dell'istanza se il codice restituito del metodo RequestStateChange è 0 o 4096. Per altre informazioni, vedere la descrizione delle proprietà EnabledState e RequestedState per l'elemento. Questo 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]

Tipo: CIM_ConcreteJob

Riferimento facoltativo a un oggetto Msvm_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]

Tipo: datetime

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

Tipo: uint32

Questo metodo restituisce uno dei valori seguenti.

Codice/valore restituito	Descrizione
Completato senza errore 0	Esito positivo.
Non supportato 1
Errore sconosciuto/non specificato 2
Impossibile completare il periodo di timeout 3
Operazione non riuscita 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
Busy 4099
Metodo riservato 4100..32767
Fornitore specifico 32768..65535

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_GuestServiceInterfaceComponent