IG_REC_output_codepage_next

Continues the enumeration of the available Code Pages and returns the name of the next one. Maximum length of the code page name is AM_MAX_CP_NAME_LEN.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_output_codepage_next_get( LPSTR pCodePageName, AT_INT nBufferLength );

Arguments:

Name	Type	Description
pCodePageName	LPSTR	Pointer of a buffer for the name of the next available Code Page.
nBufferLength	AT_INT	Length of pCodePageName buffer.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

	Copy Code
AT_ERRCOUNT ErrCount = 0; AT_ERRCODE ErrCode = IGE_SUCCESS; LPSTR lpszCodepage = 0; AT_INT iCodepageLen = AM_MAX_CP_NAME_LEN; lpszCodepage = (LPSTR) malloc(iCodepageLen); ErrCount += IG_REC_output_codepage_first_get(lpszCodepage, iCodepageLen); while(ErrCode == IGE_SUCCESS) { //... ErrCount += IG_REC_output_codepage_next_get(lpszCodepage, iCodepageLen); IG_warning_get(0, NULL, 0, NULL, &ErrCode, NULL, NULL, NULL, 0); } free(lpszCodepage);

Copy Code

AT_ERRCOUNT ErrCount = 0;
AT_ERRCODE ErrCode = IGE_SUCCESS;
LPSTR lpszCodepage = 0;
AT_INT iCodepageLen = AM_MAX_CP_NAME_LEN;

lpszCodepage = (LPSTR) malloc(iCodepageLen);
ErrCount += IG_REC_output_codepage_first_get(lpszCodepage, iCodepageLen);
while(ErrCode == IGE_SUCCESS)
{
    //...

    ErrCount += IG_REC_output_codepage_next_get(lpszCodepage, iCodepageLen);
    IG_warning_get(0, NULL, 0, NULL, &ErrCode, NULL, NULL, NULL, 0);
}

free(lpszCodepage);

Remarks:

As soon as the function finds no further code pages to get, the warning IGW_LAST_ITEM_REACHED is added to the warning stack. Function IG_warning_check() returns a non-zero value in this case, signaling that the list is complete.