ErrorInfo (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Standard functions

Exception management functions

ErrorInfo

Presentation

Example

Equivalence

HFSQL error

DDE errors

See also

ErrorInfo (Function)

In french: ErreurInfo

Retrieves information about the last error that occurred in a function of a WINDEV, WINDEV Mobile or WEBDEV component.

Caution:

ErrorInfo must be used immediately after the call to the function that failed. Indeed, calling a WLanguage function may reinitialize and modify the status report of ErrorInfo.
ErrorInfo should not be used to check whether an error has been encountered. To check if a WLanguage function has encountered an error, use one of the following methods:
- check the status report of the WLanguage function.
- check the ErrorOccurred variable.

Example

// Open the overview file
nFileID is int = fOpen(FileName, foRead)
// Check the file opening
IF nFileID = -1 THEN
Error("Unable to open the file: " + FileName, ErrorInfo())
RESULT False
END

// Error found?
IF ErrorOccurred = True THEN
// Full message of the main error
Trace(ErrorInfo())
// Browse the sub-errors (if any)
FOR i = 1 _TO_ ErrorInfo(errNumberSubError)
// Full message of each sub-error
Trace("Sub-error " + i + ": " + ErrorInfo(errMessage, i))
END
END

Syntax

Getting information about the last error Hide the details

<Result> = ErrorInfo([<Type of information>])

<Result>: Character string or integer

Requested information.
Empty string ("") if no error occurred or if the requested information is not available.

<Type of information>: Optional constant

Information to return.
errCode Error code
errDateTime Date and time of error
errDebugInfo Specific information for debugging the problem that occurred. This information should only be displayed and communicated on express demand from PC SOFT.
When running a query via OLE DB, this option allows you to retrieve the code of the SQL query currently run on the database.

errDuring Name of the WLanguage function that threw the error.
errElement Name of object associated with the current process when the error occurred.
errFIC Full name of the data file (.FIC) associated with the error.
errFile Logical name of the file associated with the error.
errFullComponentName Full name of the component being executed.
For example:
"" (empty string): main application context.
"Component1": "Component1" component directly used in the project.
"Component1.Component2": "Component2" component used from "Component1".
errFullDetails Full error details (error line, current process, etc.).
Remark: Returns the same information as the one retrieved via the "Copy" button in the WLanguage error window.
errInfo Additional information.
errItem Name of the item associated with the error.
errLine Number of the error line.
errLink Name of the link associated with the error.
errMessage
(default value) Full error message.
errMMO Full name of the memo file (.MMO) associated with the error.
errNDX Full name of the index file (.NDX) associated with the error.
errNumberSubError Number of sub-errors for the error
errProcess Name of process in progress when the error occurred.
errRecNum Number of the record associated with the error.
errStack Stack of WLanguage calls
errSummary Summary of error
errSystemCode Number of the system error (if it exists)
errSystemMessage Message of system error (if it exists).
errWDD Full name of the WDD file associated with the error.

Getting information about the sub-errors of the last error Hide the details

<Result> = ErrorInfo(<Type of information> , <Sub-error subscript>)

<Result>: Character string or integer

Requested information.
Empty string ("") if no sub-error occurred or if the requested information is not available.

<Type of information>: Constant

Information to return.
errCode Code of the sub-error.
errDateTime Date and time of sub-error.
errDebugInfo Specific information for debugging the problem that occurred. This information should only be displayed and communicated on express demand from PC SOFT.

When running a query via OLE DB, this option allows you to retrieve the code of the SQL query currently run on the database.
errDuring Name of WLanguage function that threw the sub-error.
errElement Name of object associated with the process in progress when the sub-error occurred.
errFIC Full name of data file (.FIC) associated with the sub-error.
errFile Logical name of file associated with the sub-error.
errFullDetails Full details of sub-error (sub-error line, current process, etc.).

Remark: Returns the same information as the one retrieved via the "Copy" button in the WLanguage error window.
errInfo Additional information.
errItem Name of item associated with the sub-error.
errLine Number of the sub-error line.
errLink Name of link associated with the sub-error.
errMessage
(default value) Full message of sub-error.
errMMO Full name of memo file (.MMO) associated with the sub-error.
errNDX Full name of index file (.NDX) associated with the sub-error.
errProcess Name of process in progress when the sub-error occurred.
errRecNum Number of record associated with the sub-error.
errStack Stack of WLanguage calls.
errSummary Summary of sub-error.
errSystemCode Number of the system sub-error (if it exists).
errSystemMessage Message of system error (if it exists).
errWDD Full name of WDD associated with the sub-error.

<Sub-error subscript>: Integer

Subscript of sub-error to use.
Reminder: The number of sub-errors for an error is returned by the errNumberSubError constant.

Remarks

Equivalence

Calling Error without any parameters displays the error message corresponding to the last WLanguage function that triggered an error.

In this case, the following code:

Error()

is equivalent to:

Error(ErrorInfo())

HFSQL error

When an HFSQL error occurs, ErrorInfo is equivalent to HErrorInfo.

DDE errors

To get the main DDE error codes, see DDE error codes.

Component: wd280vm.dll