IG_REC_approx_regex_progress_cb

Identifies the current approximate regex progress callback.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_approx_regex_progress_cb_get( const HIG_REC_APPROX_REGEX higRecApproxRegex, LPPFNIG_REC_APPROX_REGEX_PROGRESS_CB const lppfnCallback, LPVOID* const lppUserData );

Arguments:

Name	Type	Description
higRecApproxRegex	const HIG_REC_APPROX_REGEX	The handle to an approximate regex instance.
lppfnCallback	LPPFNIG_REC_APPROX_REGEX_PROGRESS_CB const	The far pointer indicating where to return the pointer to a progress callback function invoked while searching.
lppUserData	LPVOID* const	The far pointer indicating where to return the anonymous data passed to the progress callback function.

Return Value:

The number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

	Copy Code
AT_ERRCOUNT errCount = 0 ; HIG_REC_APPROX_REGEX higRecApproxRegex = 0 ; LPFNIG_REC_APPROX_REGEX_PROGRESS_CB user_callback = 0 ; LPVOID user_data = 0 ; IG_REC_approx_regex_create( &higRecApproxRegex ) ; errCount = IG_REC_approx_regex_progress_cb_get ( higRecApproxRegex, &user_callback, &user_data ) ; IG_REC_approx_regex_delete( higRecApproxRegex ) ;

Copy Code

AT_ERRCOUNT errCount = 0 ;
HIG_REC_APPROX_REGEX higRecApproxRegex = 0 ;
LPFNIG_REC_APPROX_REGEX_PROGRESS_CB user_callback = 0 ;
LPVOID user_data = 0 ;

IG_REC_approx_regex_create( &higRecApproxRegex ) ;
errCount = IG_REC_approx_regex_progress_cb_get 
                          ( higRecApproxRegex, 
                            &user_callback,
                            &user_data
                          ) ;
IG_REC_approx_regex_delete( higRecApproxRegex ) ;

Remarks:

Use this function to install a callback to receive progress notifications prior to completion. The callback presents an opportunity to stop the current operation.