Studio:Error Object
(Redirected from Error Object)
Jump to navigation
Jump to search
The Error Oject is used to return rich error information from asynchronous STRIDE calls. An Error Object is instantiated by STRIDE internally and is returned from ascript.WaitForEvent() instead of (or in addition to) the expected User/Owner object.
The Error Object can only be obtained as a result of calling WaitForEvent(). An Error Object is returned whenever an asynchonous operation has been previously invoked and subsequently fails. Asynchronous operations that can subsequently yield error events are limited to the following:
- Function.User.CallNonBlocking() Method
- Function.User.CallBypassOverrideNonBlocking() Method
- Message.User.SendCmd() Method
- Message.User.SendCmdBypassOverride() Method
- Message.Owner.SendRsp() Method
| Member |
Type |
Description | ||||||
| Code | Property Read-only, int |
Error code corresponding to the error. | ||||||
| Description | Property Read-only, String |
Description of the error suitable for display to the user or to write to a log file. | ||||||
| Name | Property Read-only, int |
Contains the name of the error source. Indicates the system that was the source of the error. This property is used to provide additional classification of an Error object. Values include:
| ||||||
| ShortDescription | Property Read-only, String |
Contains a canonical string of each error code (redundant to the error code). The string representation can be compared and/or switched on in a script to take specific actions. | ||||||
| Type | Property Read-only, int |
Always contains "Error". This property is present in all objects that can be returned from ascript.WaitForEvent(). The Type property is typically used to classify such an object in a script. |
Error Codes Summary
The following table summarizes the STRIDE-generated error codes along with their corresponding reasons.
| Code |
Reason |
Name |
ShortDescription |
| 31 | Function called or message sent to a receiver that is not registered. | "HostError" | "NoLocalRegistration" |
| 2 | PAL Memory allocation failed. | "HostError" | "MemoryAllocationFailure" |
| 13 | The STRIDE message queue is full. | "HostError" | "MessageQueueFull" |
| 3 | PAL notification to STRIDE failed. | "HostError" | "PalNotifyRuntimeFailure" |
| 4 | PAL user notification failed. | "HostError" | "PalNotifyUserFailure" |
| 82 | The connection to the target was lost. | "TargetError" | "ConnectionLost" |
| 85 | The call to the target terminated unexpectedly. | "TargetError" | "CallTerminated" |
| 86 | The call to the target timed out. | "TargetError" | "CallTimedOut" |
| -1 | An unexpected error occurred. | "SystemError" | "SystemError" |