Compartilhar via

Método ITaskService::Connect (taskschd.h)

  • Artigo

Conecta-se a um computador remoto e associa todas as chamadas subsequentes nessa interface a uma sessão remota. Se o parâmetro serverName estiver vazio, esse método será executado no computador local. Se o usuário não for especificado, o token atual será usado.

Sintaxe

HRESULT Connect(
  [in, optional] VARIANT serverName,
  [in, optional] VARIANT user,
  [in, optional] VARIANT domain,
  [in, optional] VARIANT password
);

Parâmetros

[in, optional] serverName

O nome do computador ao qual você deseja se conectar. Se o parâmetro serverName estiver vazio, esse método será executado no computador local.

[in, optional] user

O nome de usuário usado durante a conexão com o computador. Se o usuário não for especificado, o token atual será usado.

[in, optional] domain

O domínio do usuário especificado no parâmetro user .

[in, optional] password

A senha usada para se conectar ao computador. Se o nome de usuário e a senha não forem especificados, o token atual será usado.

Valor retornado

Esse método pode retornar um desses valores.

Valor/código retornado Descrição
S_OK
0
 A operação foi concluída com sucesso.
E_ACCESS_DENIED
0x80070005
 O acesso é negado para se conectar ao serviço agendador de tarefas.
SCHED_E_SERVICE_NOT_RUNNING
0x80041315
 O serviço Agendador de Tarefas não está em execução.
E_OUTOFMEMORY
0x8007000e
 O aplicativo não tem memória suficiente para concluir a operação ou o usuário, senha ou domínio tem pelo menos um valor nulo e um valor não nulo.
ERROR_BAD_NETPATH
53
 Esse erro é retornado nas seguintes situações:
  • O nome do computador especificado no parâmetro serverName não existe.
  • Quando você está tentando se conectar a um computador Windows Server 2003 ou Windows XP, e o computador remoto não tem a exceção de firewall de Compartilhamento de Arquivos e Impressora habilitada ou o serviço registro remoto não está em execução.
  • Quando você está tentando se conectar a um computador Windows Vista, o computador remoto não tem a exceção de firewall de Gerenciamento de Tarefas Agendadas Remotas habilitada e a exceção de firewall de Compartilhamento de Arquivos e Impressoras habilitada ou o serviço registro remoto não está em execução.
ERROR_NOT_SUPPORTED
50
 Os parâmetros de usuário, senha ou domínio não podem ser especificados ao se conectar a um computador windows XP remoto ou Windows Server 2003 de um computador Windows Vista.

Comentários

O método ITaskService::Connect deve ser chamado antes de chamar qualquer um dos outros métodos ITaskService .

Se você quiser se conectar a um computador Windows Vista remoto de um Windows Vista, precisará permitir a exceção de firewall do Gerenciamento de Tarefas Agendadas Remotas no computador remoto. Para permitir essa exceção, clique emIniciar, Painel de Controle, Segurança, Permitir um programa por meio do Firewall do Windows e, em seguida, selecione a caixa marcar gerenciamento de tarefas agendadas remotas. Em seguida, clique no botão Ok na caixa de diálogo Configurações do Firewall do Windows.

Se você estiver se conectando a um computador Windows XP ou Windows Server 2003 remoto de um computador Windows Vista, será necessário permitir a exceção de firewall de Compartilhamento de Arquivos e Impressoras no computador remoto. Para permitir essa exceção, clique emIniciar, Painel de Controle, clique duas vezes em Firewall do Windows, selecione a guia Exceções e, em seguida, selecione a exceção de firewall Compartilhamento de Arquivos e Impressoras. Em seguida, clique no botão OK na caixa de diálogo Firewall do Windows. O serviço registro remoto também deve estar em execução no computador remoto.

Nota O ITaskService::Connect pode retornar um erro SCHED_E_INVALIDVALUE ao ler a definição da tarefa se o esquema da tarefa remota não tiver suporte pelo computador atual. Para verificar a versão de esquema mais alta com suporte pelo computador atual, marcar a propriedade ITaskService::HighestVersion.
 

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho taskschd.h
Biblioteca Taskschd.lib
DLL Taskschd.dll

Confira também

ITaskService

ITaskService::HighestVersion