Metodo ITaskService::Connect (taskschd.h)

Articolo
03/15/2023

Si connette a un computer remoto e associa tutte le chiamate successive su questa interfaccia a una sessione remota. Se il parametro serverName è vuoto, questo metodo verrà eseguito nel computer locale. Se l'utente non viene specificato, viene usato il token corrente.

Sintassi

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

Parametri

[in, optional] serverName

Nome del computer a cui si desidera connettersi. Se il parametro serverName è vuoto, questo metodo verrà eseguito nel computer locale.

[in, optional] user

Nome utente utilizzato durante la connessione al computer. Se l'utente non viene specificato, viene usato il token corrente.

[in, optional] domain

Dominio dell'utente specificato nel parametro utente .

[in, optional] password

Password utilizzata per connettersi al computer. Se il nome utente e la password non vengono specificati, viene usato il token corrente.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0	Operazione riuscita.
E_ACCESS_DENIED 0x80070005	L'accesso viene negato per connettersi al servizio Utilità di pianificazione.
SCHED_E_SERVICE_NOT_RUNNING 0x80041315	Il servizio Utilità di pianificazione non è in esecuzione.
E_OUTOFMEMORY 0x8007000e	L'applicazione non dispone di memoria sufficiente per completare l'operazione o l'utente, la password o il dominio ha almeno un valore Null e un valore non Null.
ERROR_BAD_NETPATH 53	Questo errore viene restituito nelle situazioni seguenti: Il nome del computer specificato nel parametro serverName non esiste. Quando si tenta di connettersi a un computer Windows Server 2003 o Windows XP e il computer remoto non dispone dell'eccezione del firewall Condivisione file e stampanti abilitata o il servizio Registro di sistema remoto non è in esecuzione. Quando si tenta di connettersi a un computer Windows Vista e nel computer remoto non è abilitata l'eccezione del firewall Gestione attività pianificate remote e l'eccezione del firewall Condivisione file e stampanti abilitata oppure il servizio Registro di sistema remoto non è in esecuzione.
ERROR_NOT_SUPPORTED 50	Impossibile specificare i parametri utente, password o dominio quando ci si connette a un computer Windows XP o Windows Server 2003 remoto da un computer Windows Vista.

Commenti

Il metodo ITaskService::Connect deve essere chiamato prima di chiamare uno degli altri metodi ITaskService .

Se si desidera connettersi a un computer Windows Vista remoto da Windows Vista, è necessario consentire l'eccezione del firewall gestione attività pianificate remote nel computer remoto. Per consentire questa eccezione, fare clic su Start, Pannello di controllo, Sicurezza, Consenti programma tramite Windows Firewall e quindi selezionare la casella di controllo Gestione attività pianificate remote. Fare quindi clic sul pulsante OK nella finestra di dialogo Impostazioni di Windows Firewall.

Se ci si connette a un computer Windows XP o Windows Server 2003 remoto da un computer Windows Vista, è necessario consentire l'eccezione del firewall Condivisione file e stampanti nel computer remoto. Per consentire questa eccezione, fare clic su Start, Pannello di controllo, fare doppio clic su Windows Firewall, selezionare la scheda Eccezioni e quindi selezionare l'eccezione del firewall Condivisione file e stampanti. Fare quindi clic sul pulsante OK nella finestra di dialogo Windows Firewall. Anche il servizio Registro di sistema remoto deve essere in esecuzione nel computer remoto.

NotaITaskService::Connect può restituire un errore SCHED_E_INVALIDVALUE durante la lettura della definizione dell'attività se lo schema dell'attività remota non è supportato dal computer corrente. Per verificare la versione dello schema più recente supportata dal computer corrente, controllare la proprietà ITaskService::HighestVersion .

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	taskschd.h
Libreria	Taskschd.lib
DLL	Taskschd.dll

Vedi anche

ITaskService

ITaskService::HighestVersion

Condividi tramite