Método RequestReplicationStateChange da classe Msvm_ComputerSystem

  • Artigo

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