Error Codes¶
A zero indicates successful completion and a non-zero value indicates an error.
Error Codes¶
| Code | Name / Description |
|---|---|
| 0 | AW_PREFACE7_E_NO_ERRORS |
| No errors or warnings. | |
| 1 | AW_PREFACE7_E_INTERNAL_ERROR |
| An internal error occurred. | |
| 2 | AW_PREFACE7_E_NULL_PREFACE7_OBJ |
| The preface object was NULL. | |
| 3 | AW_PREFACE7_E_TRIAL_EXPIRATION_PASSED |
| The trial expiration has passed. | |
| 100 | AW_PREFACE7_E_OUT_OF_MEMORY |
| The library failed to allocate memory. | |
| 200 | AW_PREFACE7_E_INVALID_DETECTION_CONFIG |
| The handle to the detection configuration was invalid. | |
| 201 | AW_PREFACE7_E_INVALID_FACE_DETECTION_MODE |
| The face detection mode specified was an invalid value. | |
| 202 | AW_PREFACE7_E_INVALID_MINIMUM_SIZE |
| The minimum size specified must be between 0.0 and 1.0. | |
| 203 | AW_PREFACE7_E_INVALID_MAXIMUM_SIZE |
| The maximum size specified must be greater than 0.0 and less than or equal to 1.0. | |
| 204 | AW_PREFACE7_E_INVALID_RELATIVE_SIZES |
| The minimum size must be less than the maximum size specified. | |
| 205 | AW_PREFACE7_E_INVALID_GRANULARITY |
| The granularity specified must be greater than 0.0 and less than or equal to 1.0. | |
| 206 | AW_PREFACE7_E_INVALID_SENSITIVITY |
| The sensitivity specified must be greater than 0.0 and less than or equal to 1.0. | |
| 300 | AW_PREFACE7_E_INVALID_IMAGE |
| The image specified was invalid. It contained no data. | |
| 301 | AW_PREFACE7_E_INVALID_IMAGE_WIDTH |
| The image’s width was invalid. It must be a positive, non-zero number. | |
| 302 | AW_PREFACE7_E_INVALID_IMAGE_HEIGHT |
| The image’s height was invalid. It must be a positive, non-zero number. | |
| 303 | AW_PREFACE7_E_INVALID_IMAGE_STRIDE |
| The image’s stride was invalid. It must be a positive, non-zero number. The stride multiplied by the height must match the total size of the raw image data. | |
| 304 | AW_PREFACE7_E_INVALID_IMAGE_FORMAT |
| The image format specified was invalid. | |
| 400 | AW_PREFACE7_E_INVALID_FACE |
| The handle to the face object was invalid. | |
| 401 | AW_PREFACE7_E_INVALID_METRIC |
| The metric specified was an invalid value. | |
| 402 | AW_PREFACE7_E_INVALID_FACE_FEATURE |
| The face feature specified was an invalid value. | |
| 500 | AW_PREFACE7_E_INVALID_PROFILE |
| The handle to the profile object was invalid. | |
| 501 | AW_PREFACE7_E_INVALID_PROFILE_XML_BUFFER |
| The XML buffer specified was empty or could not be read. | |
| 502 | AW_PREFACE7_E_INVALID_PROFILE_XML_VERSION |
| The XML version specified was invalid. | |
| 503 | AW_PREFACE7_E_INVALID_PROFILE_XML_METRIC_NAME |
| The XML contains a Metric name that is invalid. Please see the Metrics section for a list of valid Metric names. | |
| 504 | AW_PREFACE7_E_PROFILE_VALIDATION_REQUIRED |
| The XML contains Metric elements with invalid values. Please run the profile xml through the Validate Profile function for details. PreFace 6 Profiles cannot be validated with PreFace 7. | |
| 505 | AW_PREFACE7_E_PROFILE_MISSING_REQUIRED_METRICS |
| The profile specified cannot be used to perform this function. Please see the function description for necessary profile requirements. | |
| 506 | AW_PREFACE7_E_CANNOT_PERFORM_OPERATION_WITH_PREFACE6_PROFILE |
| The requestion operation cannot be performed with a PreFace 6 Profile. Only PreFace 7 Profiles can be used with this function. | |
| 550 | AW_PREFACE7_E_INVALID_PROFILE_ERROR |
| The handle to the profile error object was invalid. | |
| 600 | AW_PREFACE7_E_INVALID_COMPLIANCE_RESULT |
| The handle to the compliance result object was invalid. | |
| 650 | AW_PREFACE7_E_INVALID_METRIC_STATUS |
| The handle to the metric status object was invalid. | |
| 700 | AW_PREFACE7_E_INVALID_AUTOCAPTURE |
| The handle to the autocapture object was invalid. | |
| 701 | AW_PREFACE7_E_INVALID_COMPLIANT_FRAME_COUNT |
| The compliant frame count was invalid. It must be a positive, non-zero number. | |
| 702 | AW_PREFACE7_E_INVALID_CAPTURE_WIDTH |
| The capture width must be a positive, non-zero number. | |
| 703 | AW_PREFACE7_E_INVALID_CAPTURE_HEIGHT |
| The capture height must be a positive, non-zero number. | |
| 800 | AW_PREFACE7_E_INVALID_CONSTRUCTION_CONFIG |
| The handle to the construction config object was invalid. | |
| 801 | AW_PREFACE7_E_INVALID_PADDING_TYPE |
| The padding type specified is invalid. | |
| 802 | AW_PREFACE7_E_INVALID_IMAGE_PROPERTY |
| The image property specified is invalid. | |
| 803 | AW_PREFACE7_E_INVALID_IMAGE_PROPERTY_VALUE |
| The value for the image property specified is invalid. Please see the image property enumeration in the documentation for valid values. | |
| 820 | AW_PREFACE7_E_CONSTRUCTION_CONFIG_MISSING_PADDING_RATIO |
| 821 | AW_PREFACE7_E_CONSTRUCTION_CONFIG_MISSING_JPEG_QUALITY |
| Construction could not be performed due to an invalid construction config set up. When using the JPEG image format, the JPEG_QUALITY image property must be set to a valid value. | |
| 822 | AW_PREFACE7_E_CONSTRUCTION_CONFIG_MISSING_J2K_PROPERTY |
| Construction could not be performed due to an invalid construction config set up. When using the J2K image format, either the FILE_SIZE or J2K_COMPRESSION image property must be set to a valid value. | |
| 823 | AW_PREFACE7_E_CONSTRUCTION_CONFIG_MISSING_FILE_SIZE |
| Construction could not be performed due to an invalid construction config set up. When using the J2K_ROI image format, the FILE_SIZE image property must be set to a valid value. | |
| 824 | AW_PREFACE7_E_CONSTRUCTION_CONFIG_MISSING_J2K_ROI_FOREGROUND_COMPRESSION |
| Construction could not be performed due to an invalid construction config set up. When using the J2K_ROI image format, the J2K_ROI_FOREGROUND_COMPRESSION image property must be set to a valid value. | |
| 825 | AW_PREFACE7_E_CONSTRUCTION_CONFIG_MISSING_J2K_ROI_BACKGROUND_COMPRESSION |
| Construction could not be performed due to an invalid construction config set up. When using the J2K_ROI image format, the J2K_ROI_BACKGROUND_COMPRESSION image property must be set to a valid value. | |
| 830 | AW_PREFACE7_E_CONSTRUCTION_FAILED_INSUFFICIENT_PADDING |
| The image could not be construted with the specified padding ratio. | |
| 831 | AW_PREFACE7_E_UNDERCONSTRAINED_PROFILE |
| The profile specified does not contain any geometric constraints and cannot be used in construction. One or two of the following metrics must be present : image_aspect_ratio, image_width, or image_height. | |
| 832 | AW_PREFACE7_E_OVERCONSTRAINED_PROFILE |
| The profile specified contains too many geometric constraints and cannot be used in construction. One or two of the following metrics must be removed : image_aspect_ratio, image_width, or image_height. | |
| 833 | AW_PREFACE7_E_CONSTRUCTION_UNSUCCESSFUL |
| The face and profile specified could not be used to construct an image. There was no way to crop, rotate, or down-scale that would result in a geometrically compliant image. | |
| 834 | AW_PREFACE7_E_CONSTRUCTION_UNSUCCESSFUL_EYE_SEPARATION_LOW |
| The face and profile specified could not be used to construct an image. The face’s eye separation is too low to meet the minimum eye separation requirements in the profile. | |
| 850 | AW_PREFACE7_E_INVALID_CONSTRUCTION_RESULT |
| The handle to the construction result object was invalid. |