Método Msvm_ComputerSystem::RequestReplicationStateChangeEx

Artigo
01/28/2024

Solicita que o estado de replicação da relação de replicação da máquina virtual seja alterado para o valor especificado. 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.

Sintaxe

uint32 RequestReplicationStateChangeEx(
  [in]  string              ReplicationRelationship,
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob Job,
  [in]  datetime            TimeoutPeriod
);

Parâmetros

ReplicationRelationship [in]: Uma representação de cadeia de caracteres de uma instância inserida da classe Msvm_ReplicationRelationship que define a relação de replicação da solicitação de alteração de estado. Esse parâmetro é opcional. Quando não for especificado, a solicitação será executada na relação de replicação primária.
RequestedState [in]: O novo estado de replicação. Deve ser um dos seguintes valores.
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 [fora]

Uma referência opcional a um objeto Msvm_ConcreteJob 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 seguintes valores.

Retornar código/valor	Descrição
Concluído sem erro 0	Êxito
Parâmetros de método verificados – Início do trabalho 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
Memória insuficiente 32778
Arquivo não encontrado 32779

Requisitos

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

Confira também

Msvm_ComputerSystem

Compartilhar via