Metodo IRegisteredTask::RunEx (taskschd.h)

Articolo
07/16/2024

Esegue immediatamente l'attività registrata usando flag specificati e un identificatore di sessione.

Sintassi

HRESULT RunEx(
  [in]            VARIANT      params,
  [in]            LONG         flags,
  [in]            LONG         sessionID,
  [in]            BSTR         user,
  [out, optional] IRunningTask **ppRunningTask
);

Parametri

[in] params

Parametri usati come valori nelle azioni dell'attività. Per non specificare valori di parametro per le azioni dell'attività, impostare questo parametro su VT_NULL o VT_EMPTY. In caso contrario, è possibile specificare una singola valore BSTR o una matrice di valori BSTR .

I valori BSTR specificati vengono associati ai nomi e archiviati come coppie nome-valore. Se si specifica un singolo valore BSTR, 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 BSTR, "0" sostituirà le variabili $(Arg0), "100" sostituirà le variabili $(Arg1) e "250" sostituirà le variabili $(Arg2) usate nelle proprietà dell'azione.

È possibile specificare un massimo di 32 valori di BSTR.

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

[in] flags

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

[in] sessionID

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

Se la costante TASK_RUN_USE_SESSION_ID non viene passata nel parametro flag, il valore specificato in questo parametro viene ignorato. Se la costante TASK_RUN_USE_SESSION_ID viene passata nei flag parametro 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 nei flag parametro e il valore sessionID è un ID di 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 mentre l'utente connesso alla sessione specificata.

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

[in] user

Utente per cui viene eseguita l'attività.

[out, optional] ppRunningTask

Interfaccia IRunningTask che definisce la nuova istanza dell'attività.

Passare un riferimento a un puntatore a interfaccia NULLIRunningTask. Fare riferimento a un puntatore null non può causare una perdita di memoria perché il puntatore verrà sovrascritto.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

Questo metodo restituirà senza errori, ma l'attività non verrà eseguita se la proprietà AllowDemandStart di ITaskSettings è impostata su false per l'attività.

Se IRegisteredTask::RunEx viene richiamato da un'attività disabilitata, verrà restituito S_OK, ma l'attività non verrà eseguita.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	taskschd.h
libreria	Taskschd.lib
dll	Taskschd.dll

Vedere anche

IRegisteredTask

'utilità di pianificazione

Condividi tramite