Función NetScheduleJobDel (lmat.h)

Artículo
03/14/2023

[NetScheduleJobDel ya no está disponible para su uso a partir de Windows 8. En su lugar, use las interfaces del Programador de tareas 2.0.

]

La función NetScheduleJobDel elimina un intervalo de trabajos en cola para ejecutarse en un equipo. Esta función requiere que el servicio de programación se inicie en el equipo al que se envía la solicitud de eliminación del trabajo.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   MinJobId,
  [in]           DWORD   MaxJobId
);

Parámetros

[in, optional] Servername

Puntero a una cadena constante que especifica el nombre DNS o NetBIOS del servidor remoto en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local.

[in] MinJobId

Identificador de trabajo mínimo. Los trabajos con un identificador de trabajo menor que MinJobId no se eliminarán.

[in] MaxJobId

Identificador máximo del trabajo. Los trabajos con un identificador de trabajo mayor que MaxJobId no se eliminarán.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.

Comentarios

Normalmente, solo los miembros del grupo de administradores locales en el equipo donde se elimina el trabajo de programación pueden ejecutar correctamente esta función. Si el nombre del servidor pasado en la cadena a la que apunta el parámetro Servername es un servidor remoto, solo los miembros del grupo administradores locales del servidor pueden ejecutar correctamente esta función.

Si el siguiente valor del Registro tiene el bit menos significativo establecido (por ejemplo, 0x00000001), los usuarios que pertenecen al grupo Operadores de servidor también pueden ejecutar correctamente esta función.

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

Llame a la función NetScheduleJobEnum para recuperar el identificador de trabajo de uno o varios trabajos programados.

La función NetScheduleJobDel elimina todos los trabajos cuyos identificadores de trabajo están en el intervalo MinJobId a través de MaxJobId.

Para eliminar todos los trabajos programados en el servidor, puede llamar a NetScheduleJobDel especificando MinJobId igual a 0 y MaxJobId igual a – 1. Para eliminar un trabajo, especifique el identificador del trabajo para el parámetro MinJobId y el parámetro MaxJobId .

Requisitos


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	lmat.h (incluir Lmat.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll