L_Doc2GetStatus

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2GetStatus(hDoc, pStatus, uStructSize)

Gets last recognition status.

Parameters

L_HDOC2 hDoc

Handle to the OCR document.

pSTATUS2 pStatus

Pointer to a STATUS2 structure to be updated.

L_UINT uStructSize

Size in bytes, of the structure pointed to by pStatus, use sizeof(STATUS2) to calculate this value.

Returns

Comments

The obtained information represents the accuracy and timing data of the last recognition operation.

⛔ CAUTION

This function must be called after calling the L_Doc2Recognize / L_Doc2RecognizeExt function; otherwise, the STATUS2 structure will be empty and may get an error. Also, this data will have status of recognition process.

Required DLLs and Libraries

• LTDOC2
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

L_INT Doc2GetStatusExample(L_HDOC2 hDoc) 
{ 
   L_INT nRet; 
   STATUS2 Status; 
   L_TCHAR szBuffer[1024]; 
 
   ZeroMemory(&Status, sizeof(STATUS2)); 
   ZeroMemory(szBuffer, sizeof(szBuffer)); 
   nRet = L_Doc2GetStatus(hDoc, &Status, sizeof(STATUS2)); 
   if (nRet == SUCCESS) 
   { 
      wsprintf(szBuffer, TEXT("Recognized Characters = %d\nRecognized Words = %d\nRejected Characters = %d\n"), 
               Status.nRecogChrCount, 
               Status.nRecogWordCount, 
               Status.nRejectChrCount); 
 
      MessageBox(NULL, szBuffer, TEXT("Notice!"), MB_OK); 
   } 
   else 
      return nRet; 
   return SUCCESS; 
}