3.2.4.2.36.3 ModifyScheduleTask (Opnum 9)

  • Article

The ModifyScheduleTask method modifies the specified task that is capable of triggering the generation of a File Server Resource Manager Protocol report job.

 [id(FSRM_DISPID_REPORT_SCHEDULER | 0x03)] HRESULT ModifyScheduleTask(
   [in] BSTR taskName,
   [in] VARIANT* namespacesSafeArray,
   [in] BSTR serializedTask
 );

taskName: Contains the name of the Task Scheduler task to modify.

namespacesSafeArray: Pointer to a variable that contains a VARIANT structure, which contains a SAFEARRAY of VARIANT structures. The VARIANT structures contained in the SAFEARRAY MUST be BSTR string values, each representing a local directory path that needs to be verified as supported by the File Server Resource Manager Protocol storage.

serializedTask: Contains the XML representation of the task to be modified.<64>

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80045301

FSRM_E_NOT_FOUND

The specified task could not be found.

0x80070057

E_INVALIDARG

This code is returned for the following reasons:

  • The taskName parameter is NULL.

  • The serializedTask parameter is NULL.

  • The taskName parameter is not a valid value.

Upon receiving this message, the server MUST validate parameters:

  • Verify that taskName is not NULL.

  • Verify that namespacesSafeArray is not NULL.

  • Verify that serializedTask is not NULL.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

The server MUST modify the specified task in such a way that it is capable of triggering File Server Resource Manager Protocol report jobs.