Método IScheduledWorkItem::D eleteTrigger (mstask.h)

[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o del producto. Use las interfaces del Programador de tareas 2.0 en su lugar. ]

Elimina un desencadenador de un elemento de trabajo.

Sintaxis

HRESULT DeleteTrigger(
  [in] WORD iTrigger
);

Parámetros

[in] iTrigger

Valor de índice del desencadenador que especifica el desencadenador que se va a eliminar. Para obtener más información, vea la sección Comentarios.

Valor devuelto

El método DeleteTrigger devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_INVALIDARG	Los argumentos no son válidos.
E_OUTOFMEMORY	No hay suficiente memoria disponible.

Comentarios

Se crea un índice de desencadenador para cada desencadenador cuando se crea el desencadenador. Sin embargo, no es un identificador único para un desencadenador específico. Por ejemplo, si crea cuatro desencadenadores, se numerarán de 0 a 3. Pero si se elimina el segundo desencadenador, los desencadenadores restantes se numerarán de 0 a 2. Tenga en cuenta que el índice del primer desencadenador siempre es 0 y el índice del último desencadenador es uno menor que el número total de desencadenadores para el elemento de trabajo (TriggerCount -1).

Puede recuperar el recuento de desencadenadores mediante IScheduledWorkItem::GetTriggerCount.

Para completar la eliminación del desencadenador, los programas deben llamar al método IPersistFile::Save después de llamar a DeleteTrigger. Al llamar a IPersistFile::Save, se guardan los cambios en el disco.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mstask.h
Library	Mstask.lib
Archivo DLL	Mstask.dll
Redistribuible	Internet Explorer 4.0 o posterior en Windows NT 4.0 y Windows 95

Consulte también

CreateTrigger

IScheduledWorkItem

IScheduledWorkItem::GetTriggerCount