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.