Método IActionCollection::Create (taskschd.h)

Crea y agrega una nueva acción a la colección.

Sintaxis

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

Parámetros

[in] type

Este parámetro se establece en una de las siguientes constantes de enumeración TASK_ACTION_TYPE.

Valor	Significado
TASK_ACTION_EXEC 0	La acción realiza una operación de línea de comandos. Por ejemplo, la acción podría ejecutar un script, iniciar un archivo ejecutable o, si se proporciona el nombre de un documento, busque su aplicación asociada e inicie la aplicación con el documento.
TASK_ACTION_COM_HANDLER 5	La acción desencadena un controlador.
TASK_ACTION_SEND_EMAIL 6	Esta acción envía un mensaje de correo electrónico.
TASK_ACTION_SHOW_MESSAGE 7	Esta acción muestra un cuadro de mensaje.

[out] ppAction

Interfaz IAction que representa la nueva acción.

Pase una referencia a un puntero de interfazIAction NULL. Hacer referencia a un puntero null nopuede provocar una pérdida de memoria porque se sobrescribirá el puntero.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Observaciones

No se pueden agregar más de 32 acciones a la colección.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	taskschd.h
biblioteca de	Taskschd.lib
DLL de	Taskschd.dll

Consulte también

de IAction

IActionCollection

IComHandlerAction

IEmailAction

IExecAction

IShowMessageAction

TASK_ACTION_TYPE

programador de tareas de