Método RequestReplicationStateChange da classe Msvm_ComputerSystem

Artigo
06/13/2023

Solicita que o estado de replicação da máquina virtual seja alterado para o valor especificado e atue na relação de replicação primária da máquina virtual. Enquanto a alteração de estado está em andamento, a propriedade ReplicationState é alterada para o valor do parâmetro RequestedState . Esse método só tem suporte para instâncias da classe Msvm_ComputerSystem que representam uma máquina virtual.

Observação

Começando com Windows 8.1, recomendamos não usar RequestReplicationStateChange mais para solicitar a alteração do estado de replicação. Em vez disso, use RequestReplicationStateChangeEx.

Sintaxe

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

Parâmetros

RequestedState [in]: O novo estado de replicação. O deve ser um dos valores a seguir.
Pronto para iniciar a replicação inicial (1): Pronto para iniciar a replicação inicial.
Aguardando para concluir a replicação inicial (2): Aguardando para concluir a replicação inicial.
Replicação (3): Replicando.
Replicação sincronizada concluída (4): Replicação sincronizada concluída.
Suspender (7): Suspender a replicação.
Cancelar Ressincronizar (9): Cancelar a ressincronização.

Trabalho [out]

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]

Este parâmetro não é usado.

Valor retornado

Esse método retorna um dos valores a seguir.

Retornar código/valor	Descrição
Concluído sem erro 0	Êxito
Parâmetros de método verificados – Trabalho iniciado 4096	A transição é assíncrona.
Com falha 32768
Acesso negado 32769
Sem suporte 32770
O status é desconhecido 32771
Tempo Limite 32772
Parâmetro inválido 32773	Não há suporte para o valor especificado em um dos parâmetros.
O sistema está em uso 32774
Estado inválido para esta operação 32775	O valor especificado no parâmetro RequestedState não tem suporte no modo ou estado de replicação atual.
Tipo de dados incorreto 32776
O sistema não está disponível 32777
Sem memória 32778
Arquivo não encontrado 32779

Requisitos

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

Confira também

Msvm_ComputerSystem

Compartilhar via