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:
|
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 |
|
DLL |
|