Error Codes
Many of the PIPLX.DLL and PICMLX.DLL functions return a numeric error code that indicates success or failure of the function call
Note:
For Visual Basic, corresponding global constants are provided in PILPXI.BAS and PICMLX.BAS
For Visual C++, corresponding enumerated constants are provided in PILPXI.H and PICMLX.H
Error codes are as follows:
PIPLX | ||
0 | NO_ERR | Success, no error |
1 | ER_NO_CARD | No Pickering card has the specified number |
2 | ER_NO_INFO | Card information unobtainable - hardware problem |
3 | ER_CARD_DISABLED | Specified card is disabled |
4 | ER_BAD_SUB | Sub-unit value out of range for target card |
5 | ER_BAD_BIT | Bit number out of range for target card |
6 | ER_NO_CAL_DATA | Target sub-unit has no calibration data to read/write |
7 | ER_BAD_ARRAY | "SafeArray type, shape or size in incorrect" |
8 | ER_MUX_ILLEGAL | Non zero write data value is illegal for MUX sub-unit |
9 | ER_EXCESS_CLOSURE | Execution would cause closure limit to be exceeded |
10 | ER_ILLEGAL_MASK | One or more of the specified channels can not be masked |
11 | ER_OUTPUT_MASKED | Can not activate an output that is masked |
12 | ER_BAD_LOCATION | Can not open a Pickering card at the specified location |
13 | ER_READ_FAIL | Failed read from hardware |
14 | ER_WRITE_FAIL | Failed write to hardware |
15 | ER_DRIVER_OP | Hardware driver failure |
16 | ER_DRIVER_VERSION | Incompatible hardware driver version |
17 | ER_SUB_TYPE | Function call incompatible with sub-unit type or capabilities |
18 | ER_BAD_ROW | Matrix row value out of range |
19 | ER_BAD_COLUMN | Matrix column value out of range |
20 | ER_BAD_ATTEN | Attenuation value out of range |
21 | ER_BAD_VOLTAGE | Voltage value out of range |
22 | ER_BAD_CAL_INDEX | Calibration reference out of range |
23 | ER_BAD_SEGMENT | Segment number out of range |
24 | ER_BAD_FUNC_CODE | Function code value out of range |
25 | ER_BAD_SUBSWITCH | Subswitch value out of range |
26 | ER_BAD_ACTION | Action code out of range |
27 | ER_STATE_CORRUPT | Cannot execute due to corrupt sub-unit state |
28 | ER_BAD_ATTR_CODE | Unrecognized attribute code |
29 | ER_EEPROM_WRITE_TMO | Timeout writing to EEPROM |
30 | ER_ILLEGAL_OP | Operation is illegal in the sub-unit's current state |
31 | ER_BAD_POT | Unrecognized pot number |
32 | ER_MATRIXR_ILLEGAL | Invalid write pattern for MATRIX sub-unit |
33 | ER_MISSING_CHANNEL | Attempted operation on non-existent channel |
34 | ER_CARD_INACCESSIBLE | Card can not be accessed (failed/removed/unpowered) |
35 | ER_BAD_FP_FORMAT | Unsupported internal floating-point format (internal error) |
36 | ER_UNCALIBRATED | Sub-unit is not calibrated |
37 | ER_BAD_RESISTANCE | Unobtainable resistance value |
38 | ER_BAD_STORE | Invalid calibration store number |
39 | ER_BAD_MODE | Invalid mode value |
40 | ER_SETTINGS_CONFLICT | Conflicting device settings |
8194 | ER_PIPLX_FUNC_NOT_LOADED | Desired function not loaded from pilpxi.dll library |
8195 | ER_PIPLX_NOT_CONNECTED | You are not connected to remote host |
8196 | ER_PIPLX_FUNC_NOT_LOCAL | Function not supported on localhost |
PICMLX | ||
4096 | ER_PICMLX_BASE | Deprecated |
4097 | ER_PICMLX_CLI_NOT_INIT | Deprecated |
4098 | ER_PICMLX_CLI_INVALID_SESSION | Client: Invalid session ID |
4099 | ER_PICMLX_CLI_HOST_UNAVAILABLE | Client: Destination host is unavailable |
4100 | ER_PICMLX_CLI_ECHOB_SERVER | Deprecated |
4101 | ER_PICMLX_CLI_ECHOB_SEND | Deprecated |
4102 | ER_PICMLX_CLI_ECHOB_OPTION | Deprecated |
4103 | ER_PICMLX_CLI_ECHOB_CREATE | Deprecated |
4104 | ER_PICMLX_CLI_ECHOD_DATA | Deprecated |
4105 | ER_PICMLX_CLI_ECHOD_RECV | Deprecated |
4106 | ER_PICMLX_CLI_ECHOD_CREATE | Deprecated |
4107 | ER_PICMLX_CLI_ECHOD_HOST | Deprecated |
4108 | ER_PICMLX_CLI_SESSION | Deprecated |
4109 | ER_PICMLX_CLI_CONNECT | Client: Can't connect to device |
4110 | ER_PICMLX_CLI_RECV_FAILED | Client: Can't receive data |
4111 | ER_PICMLX_CLI_RECV_DATA | Client: Received corrputed data |
4112 | ER_PICMLX_CLI_SEND_FAILED | Client: Can't send data |
4113 | ER_PICMLX_CLI_FUNC_NOT_LOCAL | Client: Function is not supported on local system |
4114 | ER_PICMLX_CLI_NOT_CONNECTED | Client: Session isn't connected to the device |
4115 | ER_PICMLX_CLI_PARAM_SIZE | Client: Parameter is NULL or size invalid |
Server Side | ||
4116 | ER_PICMLX_SRV_INVALID_FID | Server: Invalid function ID |
4117 | ER_PICMLX_SRV_RPC_DATA | Server: RPC data corrupt |
4118 | ER_PICMLX_SRV_INVALID_CARDID | Server: Invalid card ID |
4119 | ER_PICMLX_SRV_INVALID_ADDRESS | Server: Address of card is invalid |
4120 | ER_PICMLX_SRV_OPEN_CARD | Server: The card is in use |
4121 | ER_PICMLX_SRV_ACCESS_DENIED | Server: You haven't any rights to the card(s) |
4122 | ER_PICMLX_SRV_NOT_SUPPORTED | Server: Function is not supported by this LXI device |
4123 | ER_PICMLX_SRV_DEVICE_INFO | Server: Information about LXI device is not obtainable |
4124 | ER_PICMLX_SRV_OUT_OF_RESOURCES | Server: Out of resources |
4125 | ER_PICMLX_SRV_DATA_LENGTH | Server: Required length of data is wrong |
4126 | ER_PICMLX_SRV_CARD_TYPE | Server: LXI device has no card of this type |
4127 | ER_PICMLX_SRV_FUNC_NOT_IMPL | Server: Function is not implemented or it is reserved |
4128 | ER_PICMLX_SRV_CARD_USED_BYCLI | Server: The card is already used by the client |
4129 | ER_PICMLX_SRV_UNDEFINED | Server: Undefined error |
4130 | ER_PICMLX_SRV_WAIT_TIMEOUT | Server: Wait timeout expired |
4131 | ER_PICMLX_SRV_DEVICE_LOCKED | Server: Device is locked - another client has exclusive access |
4132 | ER_PICMLX_CLI_BONJOUR_FAILED | Deprecated |
Client Side | ||
4133 | ER_PICMLX_CLI_BEGINTRANS | Client: Transmission wasn't initiated. First call PICMLX_BeginTransmission! |
4134 | ER_PICMLX_CLI_ENDTRANS | Client: Previous transmission wasn't ended. Call PICMLX_EndTransmission first! |
4135 | ER_PICMLX_CLI_INVALID_INDEX | Client: Invalid list item index |
4136 | ER_PICMLX_CLI_DIRECTECHO_FAILED | Client: Direct discovery function failed |
4137 | ER_PICMLX_CLI_BROADCASTECHO_FAILED | Client: Broadcast discovery function failed |
Additional PIPLX Errors | ||
8194 | ER_PIPLX_FUNC_NOT_LOADED | Desired function not loaded from pilpxi.dll library |
8195 | ER_PIPLX_NOT_CONNECTED | You are not connected to remote host |
8196 | ER_PIPLX_FUNC_NOT_LOCAL | Function not supported on localhost |
PIPSLX Errors | ||
12289 | ER_PIPSLX_INVALID_SESSION | No longer used - now ER_PICMLX_INVALID_SESSION |
12290 | ER_PIPSLX_FUNC_NOT_LOCAL | Function not supported on local host |
12291 | ER_PIPSLX_NOT_CONNECTED | Not connected to remote host |
12292 | ER_PIPSLX_NOT_INIT | Library not initialized |
12293 | ER_PIPSLX_SWITCH_FAULT | Switch fault |
12294 | ER_PIPSLX_BAD_FORMAT_DATA | Data or command format bad |
12295 | ER_PIPSLX_UNKNOWN_CMD | Unknown command |
12296 | ER_PIPSLX_BUSY | Device busy |
12297 | ER_PIPSLX_SEQUPINPROGRESS | Up sequence in progress |
12298 | ER_PIPSLX_SEQDOWNINPROGRESS | Down sequence in progress |
12299 | ER_PIPSLX_CHANTESTINPROGRESS | Channel test running |
12300 | ER_PIPSLX_EMERGENCYSTOP | Emergency stop button engaged |
12301 | ER_PIPSLX_PARAM_SIZE | Parameter is NULL or invalid size |