3.1.4.3.5.4 Retrieve a Task's Scheduled Run Times

  • Article

To retrieve a task's scheduled run times, the client MUST first know the path of the task. The path of the task is determined when the client creates the task or queries the server (section 3.1.4.3.6).

Then the client MUST invoke the SchRpcScheduledRuntimes method with the following parameters:

  •  The path of the existing task in the path parameter.

  • The start of the time window (or 0 to indicate the beginning of time) in the start parameter.

  • The end of the time window (or 0 to indicate the end of time) in the end parameter.

  • Zero in the flags parameter.

  • The number of run times requested in the cRequested parameter.

  • The location of a DWORD to receive actual number of run times in the pcRuntimes parameter.

  • The location of a buffer to receive the array of run times in the pRuntimes parameter.

The client MUST deallocate the pRuntimes parameter after successful execution of the method, as specified in section 5.1.1.1 of [C706].