Metodo IActionCollection::Create (taskschd.h)

Articolo
03/02/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 da riga di comando. Ad esempio, l'azione potrebbe eseguire uno script, avviare un eseguibile o, se viene fornito 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 dell'interfaccia IActionNULL. Il riferimento a un puntatore non NULL 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 .

Commenti

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

Requisiti

Requisito	Valore
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