Metodo RegisteredTask.RunEx

Per lo scripting, esegue immediatamente l'attività registrata usando flag specificati e un identificatore di sessione.

Sintassi

RegisteredTask.RunEx( _
  ByVal params, _
  ByVal flags, _
  ByVal sessionID, _
  ByRef runningTask _
)

Parametri

params [in]

I parametri usati come valori nelle azioni dell'attività. Per non specificare i valori dei parametri per le azioni dell'attività, impostare questo parametro su Nothing. In caso contrario, è possibile specificare un singolo valore stringa o una matrice di valori stringa.

I valori stringa specificati vengono associati ai nomi e archiviati come coppie nome-valore. Se si specifica un singolo valore stringa, Arg0 sarà il nome assegnato al valore. Il valore può essere usato nell'azione dell'attività in cui viene usata la variabile $(Arg0) nelle proprietà dell'azione.

Se si passano valori come "0", "100" e "250" come matrice di valori stringa, "0" sostituirà le variabili $(Arg0), "100" sostituiranno le variabili $(Arg1) e "250" sostituiranno le variabili $(Arg2) usate nelle proprietà dell'azione.

È possibile specificare un massimo di 32 valori stringa.

Per altre informazioni e un elenco di proprietà di azione che possono usare $(Arg0), $(Arg1), ..., $(Arg32) variabili nei valori, vedere Azioni attività.

flag [in]

Costante TASK_RUN_FLAGS che definisce la modalità di esecuzione dell'attività.

sessionID [in]

Sessione del server terminale in cui si vuole avviare l'attività.

Se la costante TASK_RUN_USE_SESSION_ID (0x4) non viene passata al parametro flag , il valore specificato in questo parametro viene ignorato. Se la costante TASK_RUN_USE_SESSION_ID viene passata al parametro flag e il valore sessionID è minore o uguale a 0, verrà restituito un errore di argomento non valido.

Se la costante TASK_RUN_USE_SESSION_ID viene passata al parametro flags e il valore sessionID è un ID sessione valido maggiore di 0 e se non viene specificato alcun valore per il parametro utente , il servizio Utilità di pianificazione tenterà di avviare l'attività in modo interattivo come utente connesso alla sessione specificata.

Se la costante TASK_RUN_USE_SESSION_ID viene passata al parametro flags e il valore sessionID è un ID sessione valido maggiore di 0 e se un utente viene specificato nel parametro utente , il servizio Utilità di pianificazione tenterà di avviare l'attività in modo interattivo come utente specificato nel parametro utente .

runningTask [out]

Oggetto RunningTask che definisce la nuova istanza dell'attività.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Questo metodo restituirà senza errore, ma l'attività non verrà eseguita se la proprietà TaskSettings.AllowDemandStart è impostata su false per l'attività registrata.

Requisiti

Vedi anche

Utilità di pianificazione

RegisteredTask