CmEmbedded_4c_transp CmGetLastErrorText2

Description

This function gets the error text of the last set error. The language of the text is the current set system language or English if there is no language support for the system language. If the CM_GLET_DIALOG flag is set, the error text and some useful information are displayed in a message box (Windows / Windows CE only).

  • C, C++

Syntax

int CMAPIENTRY CmGetLastErrorText2(CMULONG flCtrl, void *pvErrorText, CMUINT cbErrorText);

Parameter

flCtrl

nav_open CM_GLET_ERRORTEXT returns the related error text of the last set error code.

CM_GLET_ERRORTEXT can be or'ed with the following flags

nav_open CM_GLET_UTF8_ENCODING represents any character in the Unicode standard.

nav_open CM_GLET_WCHAR_ENCODING uses wide character encoding in ANSI/ISO C (UCS-2 on Windows/Windows CE and UTF-32 on Unix).

pvErrorText pointer to memory to hold the data.

cbErrorText holds the length of pvErrorText in bytes.  

Return

Returns on success the number of returned bytes or zero, if an error occurred. If pvErrorText does not contain enough memory, the number of required bytes is returned.