ImageGear for C and C++ on Windows v19.7 - Updated
IG_REC_redactor_redacted_cb_get
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Redactor Functions > IG_REC_redactor_redacted_cb_get

Identifies the current redacted callback.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_redactor_redacted_cb_get(
   const HIG_REC_REDACTOR higRecRedactor,
   LPPFNIG_REC_REDACTOR_REDACTED_CB const lppfnCallback,
   LPVOID* const lppUserData
);

Arguments:

Name Type Description
higRecRedactor const HIG_REC_REDACTOR The handle to a redactor instance.
lppfnCallback LPPFNIG_REC_REDACTOR_REDACTED_CB const The far pointer indicating where to return the redacted callback function to invoke during redaction.
lppUserData LPVOID* const The far pointer indicating where to return the anonymous data passed to the redacted 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_REDACTOR higRecRedactor = 0 ;
LPFNIG_REC_REDACTOR_REDACTED_CB user_callback = 0 ;
LPVOID user_data = 0 ;

IG_REC_redactor_create( &higRecRedactor ) ;
errCount = IG_REC_redactor_redacted_cb_get 
                          ( higRecRedactor, 
                            &user_callback,
                            &user_data
                          ) ;
IG_REC_redactor_delete( higRecRedactor ) ; 

Remarks:

Use this function to install a callback to receive a notification after all match results for each page or text string are redacted.

The redactor owns all data supplied to this callback. To conserve system resources, all non-user callback data will be deleted after the callback returns. Callers that require access to callback data after the callback returns must duplicate and assume ownership of the copy.

See Also

HIG_REC_REDACTOR