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

Artículo
03/05/2024

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 interfaz IActionNULL. Hacer referencia a un puntero que no sea NULL puede provocar una pérdida de memoria porque el puntero se sobrescribirá.

Valor devuelto

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

Comentarios

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	taskschd.h
Library	Taskschd.lib
Archivo DLL	Taskschd.dll