Partilhar via


Interface IRDVTaskPlugin

A interface IRDVTaskPlugin é implementada por um agente de tarefa de atualização de máquina virtual para permitir que o agente de tarefas gerencie atualizações do sistema para uma máquina virtual. Essa interface é usada pelo agente de gatilho, que é implementado pelo sistema host.

Membros

A interface IRDVTaskPlugin herda da interface IUnknown . IRDVTaskPlugin também tem estes tipos de membros:

Métodos

A interface IRDVTaskPlugin tem esses métodos.

Método Descrição
Initialize Chamado para inicializar o agente de tarefas.
StartTask Chamado para iniciar a tarefa de atualização na máquina virtual.
Encerrar Chamado quando o agente de tarefas está sendo desligado.

Propriedades

A interface IRDVTaskPlugin tem essas propriedades.

Propriedade Tipo de acesso Descrição
PluginName
Somente leitura
Contém o nome de exibição do agente de tarefa.

Comentários

O agente de tarefas é executado na máquina virtual quando essa máquina virtual é agendada para uma atualização do sistema. O agente de tarefas atualiza a máquina virtual quando o método StartTask é chamado.

Para registrar o agente de tarefas, adicione a seguinte chave ao registro da máquina virtual:

HKEY_LOCAL_MACHINE\Software\Microsoft\\ Windows NT CurrentVersion\Terminal Server\Task\Plugins\TaskAgentName

Sob essa chave do Registro, adicione os seguintes valores:

Nome Tipo Descrição
CLSID
REG_SZ
Uma cadeia de caracteres que representa o CLSID do agente de tarefa.
IsEnabled
REG_DWORD
0 se o agente de tarefas estiver desabilitado ou 1 se o agente de tarefas estiver habilitado.

Observação

Mais de um agente de tarefas pode ser registrado, mas apenas um agente de tarefas será usado. Se mais de um agente de tarefas estiver habilitado, somente o primeiro encontrado será usado.

Embora essa interface tenha suporte nos sistemas operacionais identificados nos Requisitos abaixo, ela só será usada se a máquina virtual estiver hospedada em Windows Server 2012.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 7 Enterprise
Servidor mínimo com suporte
Windows Server 2008 R2