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 |