Método Msvm_GuestServiceInterfaceComponent::RequestStateChange

Artigo
06/13/2023

Solicita que o estado do componente da interface de serviço convidado seja alterado para o valor especificado.

Sintaxe

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

Parâmetros

RequestedState [in]

Tipo: uint16

O novo estado. As informações serão colocadas na propriedade RequestedState da instância se o código de retorno do método RequestStateChange for 0 ou 4096. Para obter mais informações, consulte a descrição das propriedades EnabledState e RequestedState para o elemento . Esse deve ser um dos valores a seguir.

Habilitado (2)

Desabilitado (3)

Desligar (4)

Offline (6)

Teste (7)

Adiar (8)

Quiesce (9)

Reinicialização (10)

Redefinir (11)

DMTF Reservado (..)

Fornecedor Reservado (32768..65535)

Trabalho [out]

Tipo: CIM_ConcreteJob

Uma referência opcional a um objeto Msvm_ConcreteJob que será retornado se a operação for executada de forma assíncrona. Se presente, a referência retornada pode ser usada para monitorar o progresso e obter o resultado do método.

TimeoutPeriod [in]

Tipo: datetime

Um período de tempo limite que especifica a quantidade máxima de tempo que o cliente espera que a transição para o novo estado leve. O formato de intervalo deve ser usado para especificar o período de tempo limite. Um valor de 0 ou Null indica que o cliente não tem requisitos de tempo para a transição. Se essa propriedade não contiver 0 ou Null e a implementação não der suporte a esse parâmetro, um código de retorno de 4098 (Use Of Timeout Parameter Not Supported) deverá ser retornado.

Valor retornado

Tipo: uint32

Esse método retorna um dos valores a seguir.

Código/valor de retorno	Descrição
Concluído sem erro 0	Sucesso.
Sem suporte 1
Erro desconhecido/não especificado 2
NÃO é possível concluir dentro do Período de Tempo Limite 3
Com falha 4
Parâmetro inválido 5
Em uso 6
DMTF Reservado ..
Parâmetros de método verificados – Transição iniciada 4096
Transição de estado inválida 4097
Não há suporte para o uso do parâmetro Timeout 4098
Ocupado 4099
Método Reservado 4100..32767
Específico do fornecedor 32768..65535

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Namespace	\\Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Confira também

Msvm_GuestServiceInterfaceComponent

Compartilhar via