get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfo (Operator)


get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfo — Returns the extended error information for the calling thread's last HALCON error.


get_extended_error_info( : : : OperatorName, ErrorCode, ErrorMessage)

Herror get_extended_error_info(char* OperatorName, Hlong* ErrorCode, char* ErrorMessage)

Herror T_get_extended_error_info(Htuple* OperatorName, Htuple* ErrorCode, Htuple* ErrorMessage)

void GetExtendedErrorInfo(HTuple* OperatorName, HTuple* ErrorCode, HTuple* ErrorMessage)

static HString HSystem::GetExtendedErrorInfo(Hlong* ErrorCode, HString* ErrorMessage)

static void HOperatorSet.GetExtendedErrorInfo(out HTuple operatorName, out HTuple errorCode, out HTuple errorMessage)

static string HSystem.GetExtendedErrorInfo(out int errorCode, out string errorMessage)


get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfo returns the last error code that occurred in the calling thread. OperatorNameOperatorNameOperatorNameOperatorNameoperatorName contains the operator name of the HALCON operator that has set this error code. ErrorCodeErrorCodeErrorCodeErrorCodeerrorCode holds the actual error code and ErrorMessageErrorMessageErrorMessageErrorMessageerrorMessage the corresponding error message. If no error code has been set so far or a HALCON error comes with no extended error information, OperatorNameOperatorNameOperatorNameOperatorNameoperatorName and ErrorMessageErrorMessageErrorMessageErrorMessageerrorMessage contain an empty string and ErrorCodeErrorCodeErrorCodeErrorCodeerrorCode is set to 0. Please refer to 'Result' slot of the particular operator reference to determine whether and on which occasion an operator provides extended error information.

get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfo is thread-local, i.e., the extended error information is maintained on a per thread basis. Setting an extended error code in one thread does not affect the extended error information in any other thread. This also implies that an error code can only be retrieved within the thread that was calling the operator setting the extended error. A thread-local extended error will be cleared (and set again when applicable) as soon as an error occurs in any other successive operator call within the same thread or the thread terminates.

Execution Information


OperatorNameOperatorNameOperatorNameOperatorNameoperatorName (output_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Operator that set the error code.

ErrorCodeErrorCodeErrorCodeErrorCodeerrorCode (output_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Extended error code.

ErrorMessageErrorMessageErrorMessageErrorMessageerrorMessage (output_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Extended error message.

See also