MagTek Excella Windows API99875313 - Manual (Page 40)

Excella Windows API Specifications
32
MTMICRGetSectionCount
MTMICRGetSectionCount function returns the number of section present in a null terminated buffer which
contains a set of key/value pairs. The key/value pairs get stored in the buffer using function MTMICRSetValue or
MTMICRSetIndexValue.
ULONG MTMICRGetSectionCount (
char *pcData,
DWORD *pdwSectionCount
);
Parameters
pcData
Pointer to null terminated string containing a set of key/value pairs.
pdwSectionCount
When the function returns, this variable contains the number of sections present in the pcData.
Return Values
MICR_ST_OK
MICR_ST_BAD_PARAMETER
MICR_ST_ERR_GET_DOM_POINTER
MICR_ST_ERR_LOAD_XML
MICR_ST_SECTION_NOT_FOUND
Remarks
If the function succeeds MICR_ST_OK is returned.
Example
char Settings [4096];
char DocInfo [4096];
char device[4096] ="";
DWORD SettingsBufferSize;
DWORD DocInfoSize;
char cValue [1024];
DWORD valueSize;
DWORD dwStatus;
// Intialize Settings
DocInfoSize = 4096;
// Use function MTMICRGetDevice to get device name for variable “device”
// Call MTMICRProcessCheck function to process a document.
dwStatus = MTMICRProcessCheck (device, Settings, DocInfo, &DocInfoSize);
if (dwStatus == MICR_ST_OK)
{