3.1 Overview

All the MSI library functions return a value that indicates the success or failure of the function call. MSI library functions can return one of the following values:

0

function success

-1

function error

If a function fails, the error can be retrieved using the Standard Runtime Library (SRL) ATDV_LASTERR( ) function.

Notes:

1. The ms_open( ) function is the exception to the above error-handling rules. An ms_open( ) function call returns a device handle if the function call is successful. A device handle is a non-zero value. If ms_open( ) fails, the return code is -1 and the specific error is found in the global variable errno defined in errno.h.
2. The Standard Attribute functions ATDV_LASTERR( ) and ATDV_ERRMSGP( ) can be used to obtain the last error that occurred on a device. Refer to the Standard Runtime Library API Library Reference for more information on these functions.
3. For Windows only: If the error returned by ATDV_LASTERR( ) is E_MSSYSTEM, a Windows system error has occurred. Check the global variable errno defined in errno.h.

For a complete list of MSI errors, see the Modular Station Interface API Library Reference.

Click here to contact Telecom Support Resources