Método ITaskService::Connect (taskschd.h)
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 |
|---|---|
|
A operação foi concluída com sucesso. |
|
O acesso é negado para se conectar ao serviço agendador de tarefas. |
|
O serviço Agendador de Tarefas não está em execução. |
|
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. |
|
Esse erro é retornado nas seguintes situações:
|
|
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.
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 |