NetScheduleJobDel

The NetScheduleJobDel function deletes a range of jobs queued to run at a computer. This function requires that the Schedule service be started at the computer to which the job deletion request is being sent.

Security Requirements

Only members of the Administrators local group can successfully execute NetScheduleJobDel on a remote server.

NET_API_STATUS NetScheduleJobDel(
  LPWSTR Servername,  
  DWORD MinJobId,     
  DWORD MaxJobId      
);
 

Parameters

Servername

Pointer to a Unicode string containing the name of the remote server on which the function is to execute. A NULL pointer or string specifies the local computer.

MinJobId

Minimum job identifier. Jobs with a job identifier smaller than MinJobId will not be deleted.

MaxJobId

Maximum job identifier. Jobs with job identifier bigger than MaxJobId will not be deleted.

Remarks

This function deletes all jobs whose job identifier is in the range MinJobId through MaxJobId. To delete all jobs at the server, you can call this function with MinJobId equal to 0 and MaxJobId equal to (DWORD) – 1. To delete just one particular job, you can choose MinJobId and MaxJobId both equal to the identifier for that job.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmat.h.
  Import Library: Use netapi32.lib.

See Also

Networking (Net) Overview, Net Functions, NetScheduleJobAdd