Skip to content

IGR_Close_Page

IGR_Close_Page releases the resources associated with the page handle. It must be called for every page opened by IGR_Open_Page, and must be called before closing the document with IGR_Close_File.

Prototype

IGR_LONG IGR_Close_Page(
    HPAGE PageHandle,
    Error_Control_Block* Error);

Parameters

PageHandle: HPAGE

Handle to a page opened by IGR_Open_Page.

Error: Pointer to Error_Control_Block

Returns error details if the call fails.

Return value

Success: IGR_LONG

Returns IGR_OK.

Failure: IGR_LONG

Returns one of the possible IGR_E error codes.

Sample code

Error_Control_Block ISYSError;
IGR_LONG Caps, DocType, DocHandle, PageCount;
HPAGE PageHandle;

IGR_LONG RC = IGR_Open_Stream(pStream, IGR_FORMAT_IMAGE, &Caps, &DocType, &DocHandle, &ISYSError);
if (RC == IGR_OK)
{
    if (IGR_Get_Page_Count(DocHandle, &PageCount, &ISYSError) == IGR_OK)
    {
        for (IGR_LONG PageIndex = 0; PageIndex < PageCount; PageIndex++)
        {
            if (IGR_Open_Page(DocHandle, PageIndex, &PageHandle, &ISYSError) == IGR_OK)
            {
                // Process Page Element
                IGR_Close_Page(PageHandle, &ISYSError);
            }
        }
     }
    IGR_Close_File(DocHandle, &ISYSError);
}