ErrorReport

Displays a Retry/Cancel requester for an error (V36)

Based on the request type, this function formats the appropriate requester to be displayed. If the code is not understood, it returns DOSTRUE immediately. Returns DOSTRUE if the user selects CANCEL or if the attempt to put up the requester fails, or if the Process pr_WindowPtr is -1. Returns FALSE if the user selects Retry. The function will retry on DISKINSERTED for appropriate error codes. These return values are the opposite of what AutoRequest returns.

This function is supposed to set IoErr() to code before returning. See the BUGS section for limitations and workarounds.

code

Error code to put a requester up for. Current valid error codes are: - ERROR_DISK_NOT_VALIDATED

• ERROR_DISK_WRITE_PROTECTED
  
  
• ERROR_DISK_FULL
  
  
• ERROR_DEVICE_NOT_MOUNTED
  
  
• ERROR_NOT_A_DOS_DISK
  
  
• ERROR_NO_DISK
  
  
• ABORT_DISK_ERROR /* read/write error */
  
  
• ABORT_BUSY /* you MUST replace... */
  
  

type

Request type: REPORT_LOCK - arg1 is a Lock (BPTR).

REPORT_FH

arg1 is a FileHandle (BPTR).

REPORT_VOLUME

arg1 is a volumenode (C pointer).

REPORT_INSERT

arg1 is the string for the volumename (will be split on a ':'). With ERROR_DEVICE_NOT_MOUNTED puts up the "Please insert..." requester.

arg1

variable parameter (see type)

device

(Optional) Address of handler Task for which report is to be made. Only required for REPORT_LOCK, and only if arg1==NULL.

status

Cancel/Retry indicator (0 means Retry)

ErrorReport() is supposed to set IoErr() to error_code before returning. In V36-V47.26 it would only set IoErr() to error_code for the error codes listed in the INPUTS section. For all other codes, the IoErr() status prior to calling ErrorReport() would persist.

If you need to be sure that the IoErr() return value matches the error code you pass to ErrorReport() in case the status returned is not 0 (0 means Retry), call SetIoErr(error_code) prior to calling ErrorReport().

ErrorReport() cannot be called from a Task because it assumes that is getting called from a Process.

Fault(), IoErr()