Opens an i18n message catalog.
Syntax
IppStatus ippMessageCatalogOpenI18n(IppMsgCatalog** ppMsgCatalog);
Parameters
ppMsgCatalog |
Double pointer to the message catalog |
Description
The function ippMessageCatalogOpenI18n is declared in the ippcore.h file. This function opens the i18n message catalog ppMsgCatalog containing the translated strings.
Caution
This function allocates memory that can be freed only by the function ippMessageCatalogCloseI18n. Always use the function ippMessageCatalogCloseI18n after opening the message catalog regardless of the returned status value.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error condition when the ppMsgCatalog pointer is NULL. |
ippStsMemAllocErr |
Indicates an error condition when no memory allocated. |
ippStsI18nUnsupportedErr |
Indicates an error condition when the internationalization i18n is not supported. |
ippStsI18nMsgCatalogOpenErr |
Indicates an error condition when the message catalog cannot be opened; to get extended information use errno on Linux* OS and GetLastError on Windows* OS. |