Método TaskService.Connect

Para scripts, 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 a userId não for especificada, o token atual será usado.

Sintaxe

TaskService.Connect( _
  [ ByVal serverName ], _
  [ ByVal user ], _
  [ ByVal domain ], _
  [ ByVal password ] _
)

Parâmetros

serverName [in, opcional]

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.

usuário [in, opcional]

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.

domínio [in, opcional]

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

password [in, opcional]

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 não retorna um valor.

Comentários

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

Se o método Connect falhar, você poderá coletar o identificador de erro para encontrar o significado do erro. A tabela a seguir lista os identificadores de erro e suas descrições.

Identificador de erro	Descrição
0x80070005	O acesso é negado para se conectar ao serviço agendador de tarefas.
0x80041315	O serviço Agendador de Tarefas não está em execução.
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.
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.
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.

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 em Iniciar, 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 em Iniciar, 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.

Requisitos

Requisito	Valor
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]
Biblioteca de tipos	Taskschd.tlb
DLL	Taskschd.dll