ErrorInfo (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Equivalence
HFSQL error
DDE errors

WINDEV

WEBDEV

WINDEV Mobile

Others

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 re-initialize 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
errSystemCode Number of the system error (if it exists)
errFullDetails Full error details (error line, current process, etc.).
Remark: Returns the same information as the one retrieved when clicking the "Copy" button in the error window of WLanguage.
errDateTime Date and time of 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.
errInfo Additional information.
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.

errLink Name of link associated with the error.
errLine Number of the error line.
errMessage
(default value) Full error message.
errSystemMessage Message of system error (if it exists).
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
errFullComponentName Full name of component currently run.
For example:
"" (empty string): main application context.
"Component1": "Component1" component directly used in the project.
"Component1.Component2": "Component2" component used from "Component1".
errRecNum Number of the record associated with the error.
errDuring Name of the WLanguage function that threw the error.
errStack Stack of WLanguage calls
errSummary Summary of error
errItem Name of the item associated with the error.
errProcess Name of process in progress when the error occurred.
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.
errSystemCode Number of the system sub-error (if it exists).
errFullDetails Full details of sub-error (sub-error line, current process, etc.).

Remark: Returns the same information as the one retrieved when clicking the "Copy" button in the error window of WLanguage.
errDateTime Date and time of 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.
errInfo Additional information.
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.
errLink Name of link associated with the sub-error.
errLine Number of the sub-error line.
errMessage
(default value) Full message of sub-error.
errSystemMessage Message of system error (if it exists).
errMMO Full name of memo file (.MMO) associated with the sub-error.
errNDX Full name of index file (.NDX) associated with the sub-error.
errRecNum Number of record associated with the sub-error.
errDuring Name of WLanguage function that threw the sub-error.
errStack Stack of WLanguage calls.
errSummary Summary of sub-error.
errItem Name of item associated with the sub-error.
errProcess Name of process in progress when the sub-error occurred.
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. Remark: From version 19, HFSQL is the new name of HyperFileSQL.

DDE errors

See DDE error codes to find out the main DDE error codes.

Component: wd270vm.dll