Metodo IActionCollection::Create (taskschd.h)

Articolo
07/16/2024

Crea e aggiunge una nuova azione alla raccolta.

Sintassi

HRESULT Create(
  [in]  TASK_ACTION_TYPE type,
  [out] IAction          **ppAction
);

Parametri

[in] type

Questo parametro è impostato su una delle costanti di enumerazione TASK_ACTION_TYPE seguenti.

Valore	Significato
TASK_ACTION_EXEC 0	L'azione esegue un'operazione della riga di comando. Ad esempio, l'azione potrebbe eseguire uno script, avviare un eseguibile o, se viene specificato il nome di un documento, trovare l'applicazione associata e avviare l'applicazione con il documento.
TASK_ACTION_COM_HANDLER 5	L'azione genera un gestore.
TASK_ACTION_SEND_EMAIL 6	Questa azione invia un messaggio di posta elettronica.
TASK_ACTION_SHOW_MESSAGE 7	Questa azione mostra una finestra di messaggio.

[out] ppAction

Interfaccia IAction che rappresenta la nuova azione.

Passare un riferimento a un puntatore a interfaccia NULLIAction. 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

Non è possibile aggiungere più di 32 azioni alla raccolta.

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