3.2.5.4.14 SchRpcDelete (Opnum 13)

  • Article

The SchRpcDelete method MUST delete a task or folder in the task store.

 HRESULT SchRpcDelete(
   [in, string] const wchar_t* path,
   [in] DWORD flags
 );

path: MUST be the full path to the task or folder to delete using the format specified in section 2.3.11.

flags: Unused. The client MUST set to zero and the server MUST return an error if nonzero.

Return Values: For more information on return codes, see section 2.3.14, or Win32 Error Codes in [MS-ERREF] section 2.1.

Upon receipt of the SchRpcDelete call, the server MUST:

  • Return E_INVALIDARG if the path parameter is NULL or if the root or the flags parameter is nonzero.<76>

  • Return the value 0x8007007B, the HRESULT form of the Win32 error ERROR_INVALID_NAME, if the specified path is not in the format specified in section 2.3.11.

  • Return the value 0x80070003, the HRESULT form of the Win32 error ERROR_PATH_NOT_FOUND, if the specified path does not exist on the server in the XML task store.

  • Return the HRESULT form of the Win32 error ERROR_FILE_NOT_FOUND if the task specified in the path parameter does not exist on the server or the file specified by the path parameter does not exist in the XML task store.<77><78>

  • Return E_ACCESSDENIED if the caller does not have delete access to the path in the XML task store.<79>

  • Delete the task from the XML task store.

  • Return S_OK.