Error Messages
Some functions return a SUCCESSFUL_RETURN or 0 (zero) value if they are successful. If it is not successful, the function returns an error code. In order to retrieve error messages, call getErrorMessage(int errorCode). For example:
Server *server = NULL;
int nRet;
//Create Server
server = createServer();
//set the property to the server
...
//Connect to server
printf("Making connection to the server...\n");
nRet = serverConnect(server);
if(nRet != SUCCESSFUL_RETURN)
{
// ASCII Version-use the following code
printf(getErrorMessage(nRet));
//Unicode Version -use the following code
UChar * error = getErrorMessage(nRet));
// more code to print out the error messageÂ….
return ;
}
The C API uses the following error messages.
- Error messages for passing a null structure:
- "Input null DataRow"
- "Input null DataTable"
- "Input null Message"
- "Input null Server"
- Error messages for connections:
- "Connection type not supported"
- "Client timeout"
- "Blank connection property name"
- "Blank property name"
- Error messages for creating DataTable:
- "Blank column name"
- "Duplicated column name"
- Error messages for MessagePackaging Exception:
- "Input Message is null"
- "Failed to connect to Server"
- "Failed to disconnect from Server"
- "Failed to open Http Connection"
- "Failed to get Service"
- "Failed to package the message using Serializer and Encoding"