DRMAPI FC3SetTemplateData ( const FC3Template_t hTemplateHandle,
const BYTE *const pTemplateData,
const size_t nTemplateSize,
const char *const szFormat
)
function to set template data
This function is used to set external data to a fingerprint template. The user must also provide the format type of the template data. Note that you can only set template types which are supported by your license of the FingerCode3 component. A simple validity check is performed upon setting the data. This should lead to rejection of corrupt data.
Parameters:
[out] hTemplateHandle handle of the template to set the data to
[in] pTemplateData pointer to a memory block containing the template data
[in] nTemplateSize the size of the template data memory block
[in] szFormat a string defining the format to import, please refer to the Features for supported formats, note that the supported formats also depend on your FingerCode3 license, check also that all *.dpl are located in the same directory as the dynamic library of the component
Returns:
error status of the function. See ErrorCodes.h for all definitions of error codes. Likely error codes are
FPC_SUCCESS the finger template data was successfully set.
FPC_ERROR_NOT_INITIALIZED the component is not initialized or no license has been found
FPC_ERROR_NO_LICENCE the component has no license, currently the component is dongled to Dermalog live scanner or Dermalog Licenser
FPC_ERROR_NO_LICENCE_INSTALLED the licenser (Dermalog live scanner or Dermalog Licenser) is not installed, please reinstall the component
FPC_ERROR_NO_HANDLE There is no handle given (hHandle == NULL)
FPC_ERROR_INVALID_HANDLE The handle given is invalid
FPC_ERROR_TEMPLATE_PTR_NULL The data pointer (pTemplate) given is NULL (passing a NULL pointer is only valid in order to delete the content template handle, the size passed must be 0 in this case)
FPC_ERROR_TEMPLATE_SIZE The size of the data pointer is invalid (passing 0 is only valid for deleting the content of the template handle. In this case the pTemplate pointer must be NULL)
FPC_ERROR_PARAM_OUT_OF_RANGE Format descriptor does not describe a supported format, this could either be a typo in the string, or the format is not supported, because the license did not include this format
FPC_ERROR_FORMAT_NOTSUPPORTED the format is not supported, because the license did not include this format, please also check that all *.dpl files are located in the same directory as the dynamic library of the component
FPC_ERROR_UNKNOWN_CODEC The memory buffer content is not recognized as a valid template of the given format
FPC_ERROR_TEMPLATE1_BAD The memory buffer content is not recognized as a valid template of the given format or you have tried to set a multiprint template
Partager