L_Doc2GetStatus

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2GetStatus(hDoc, pStatus, uStructSize)

L_HDOC2 hDoc;	/* handle to the OCR document */
pSTATUS2 pStatus;	/* pointer to STATUS2 structure */
L_UINT uStructSize;	/* size of the structure */

Gets last recognition status.

Parameter	Description
hDoc	Handle to the OCR document.
pStatus	Pointer to a STATUS2 structure to be updated.
uStructSize	Size in bytes, of the structure pointed to by pStatus, use sizeof(STATUS2) to calculate this value.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Returns information about the accuracy and timing data of the last recognition operation.

Call this function after calling the L_Doc2Recognize function. Since if you call this function before, then 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.

See Also

Functions:	L_Doc2Recognize, L_Doc2SetRecognitionResultOptions, L_Doc2GetRecognitionResultOptions, L_Doc2EnumOutputFileFormats, L_Doc2GetTextFormatInfo, L_Doc2SaveResultsToFile, L_Doc2SetSpecialChar, L_Doc2GetSpecialChar, L_Doc2GetRecognizedCharacters, L_Doc2SetRecognizedCharacters, L_Doc2FreeRecognizedCharacters, L_Doc2GetRecognizedCharactersColors
Topics:	OCR Functions: Recognition
	Recognizing Document Pages

Example

L_LTDOC2TEX_API  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;
}