ImageGear Professional DLL v17.1 for Windows Accusoft
IG_fltr_metad_callback_get
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Core Component API Reference > Core Component Functions Reference > Filter Functions > IG_fltr_metad_callback_get

Glossary Item Box

This function returns the callback functions that ImageGear uses to pass or receive metadata during save and load operations.

Declaration:

  Copy Code
AT_ERRCODE ACCUAPI IG_fltr_metad_callback_get(
   LPVOID * lpPrivate,
   LPAFT_IG_METAD_ITEM_SET_CB * lplpfnSetCB,
   LPAFT_IG_METAD_ITEM_ADD_CB * lplpfnAddCB,
   LPAFT_IG_METAD_ITEM_GET_CB * lplpfnGetCB
);

Arguments:

lpPrivate Returns private data associated with metadata callback functions.
lplpfnSetCB Returns pointer to callback function of type LPAFT_IG_METAD_ITEM_SET_CB that is used for Set metadata operation.
lplpfnAddCB Returns pointer to callback function of type LPAFT_IG_METAD_ITEM_ADD_CB that is used for Add metadata operation.
lplpfnGetCB Returns pointer to callback function of type LPAFT_IG_METAD_ITEM_GET_CB that is used for Get metadata operation.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

See GUI component source code.

Example:

  Copy Code
AT_ERRCOUNT nErrcount;        // Count of returned errors on stack
LPVOID lpPrivate;
LPAFT_IG_METAD_ITEM_SET_CB lpfnSetCB;
LPAFT_IG_METAD_ITEM_ADD_CB lpfnAddCB;
LPAFT_IG_METAD_ITEM_GET_CB lpfnGetCB;

// Get metadata callback functions
nErrcount = IG_fltr_metad_callback_get(&lpPrivate, &lpfnSetCB, &lpfnAddCB, &lpfnGetCB);

Remarks:

A NULL value is valid for any parameter, if the corresponding information is not necessary to the application.

See also IG_fltr_metad_callback_set, LPAFT_IG_METAD_ITEM_ADD_CB, LPAFT_IG_METAD_ITEM_GET_CB, LPAFT_IG_METAD_ITEM_SET_CB functions and the section Processing of non-image data through filter callback functions.

©2012. Accusoft Corporation. All Rights Reserved.