Compartilhar via

Método ITaskScheduler::SetTargetComputer (mstask.h)

  • Artigo

[[Essa API pode estar alterada ou indisponível em versões subsequentes do sistema operacional ou do produto. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0 .] ]

O método SetTargetComputer seleciona o computador no qual a interface ITaskScheduler opera, permitindo o gerenciamento remoto de tarefas e a enumeração.

Sintaxe

HRESULT SetTargetComputer(
  [in] LPCWSTR pwszComputer
);

Parâmetros

[in] pwszComputer

Um ponteiro para uma cadeia de caracteres largos terminada em nulo que especifica o nome do computador de destino para a instância atual da interface ITaskScheduler . Especifique o nome do computador de destino no formato UNC (Convenção de Nomenclatura Universal). Para indicar o computador local, defina esse valor como NULL ou como o nome UNC do computador local.

Nota Ao especificar um nome de computador remoto, use dois caracteres de barra invertida (\\) antes do nome do computador. Por exemplo, use "\\ComputerName" em vez de "ComputerName".
 

Retornar valor

O método SetTargetComputer retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
SCHED_E_SERVICE_NOT_INSTALLED
 O serviço Agendador de Tarefas não está instalado no computador de destino.
E_ACCESS_DENIED
 O usuário não tem acesso ao computador remoto.
E_INVALIDARG
 O parâmetro pwszComputer não é válido.
E_OUTOFMEMORY
 Ocorreu uma falha de alocação de memória.

Comentários

Para que um computador Windows Server 2003, Windows XP crie, monitore ou controle tarefas em um computador Windows Vista, as operações a seguir devem ser concluídas no computador Windows Vista e o usuário que está chamando o método ITaskScheduler::SetTargetComputer deve ser membro do grupo Administradores no computador remoto do Windows Vista.

Habilitar a exceção "Compartilhar Arquivo e Impressoras" no Firewall do Windows

  1. Clique em Iniciar e em Painel de Controle.
  2. Em Painel de Controle, clique em Modo de Exibição Clássico e clique duas vezes no ícone Firewall do Windows.
  3. Na janela Firewall do Windows, clique na guia Exceções e selecione Arquivo e Compartilhamento de Impressora marcar caixa.

Habilitar o serviço "Registro Remoto"

  • Abra uma janela do Prompt de Comando e insira o seguinte comando: net start "Registro Remoto"

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mstask.h
Biblioteca Mstask.lib
DLL Mstask.dll

Confira também

ITaskScheduler