Metodo IRegisteredTask::Run (taskschd.h)

Esegue immediatamente l'attività registrata.

Sintassi

HRESULT Run(
  [in]            VARIANT      params,
  [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 un valore BSTR singolo 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à.

[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à.

La funzione IRegisteredTask::Run equivale alla funzione IRegisteredTask::RunEx con il parametro flags uguale a 0 e il parametro utente uguale a NULL.

Se iRegisteredTask::Run viene richiamato da un'attività disabilitata, restituirà SCHED_E_TASK_DISABLED.

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