Document Title Here
AET65 API
Version 1.0
idvation GmbH
Otto-Hesse-Straße 19 / T5
Phone +49 6151 9926567
D-64293 Darmstadt
Fax +49 6151 3689296
www.idvation.com
Page 36 of 84
Page 36 of 84
3.5.11.
ABSGetLastErrorInfo
void ABSGetLastErrorInfo(
OUT ABS_DWORD *pErrorCode
OUT const ABS_CHAR **ppErrorMessage
)
Description
Retrieves additional information about last BSAPI error, which
occurred in the current thread.
Please note that information provided by this function is not intended
to be displayed to the end user. The error messages are in English
(they are never localized) and they are meant as a hint for
developers to make problem diagnosis easier.
Parameters
pErrorCode
Output parameter set to additional system dependent error code.
Depending on system it might be error or value returned
byGetLastError on Windows platforms or any other error code. It
might give developer a hint what's going wrong.
ppErrorMessage
On output this is set to point to a buffer containing zero-terminated
string with textual message.
If no message is provided, it points to empty string so the caller does
not need check it for NULL.
The buffer is managed by BSAPI; do not use ABSFree to release it.
Note that the buffer is valid only until other BSAPI call is performed
in the same thread. After the next call, the buffer may be released or
reused by BSAPI. If you need to remember the message, you have
to copy it into your own buffer.
3.5.12.
ABSEscape
ABS_STATUS ABSEscape(
IN ABS_DWORD dwOpcode
IN ABS_DATA *pInData
OUT ABS_DATA **ppOutData
)
Description
Requests special function to be processed.
Parameters
dwOpcode
Code of operation to perform.
No codes are currently supported. I.e. in this BSAPI version, calling this
function always fails.
pInData
Input data, passed to the function requested by dwOpcode.
Format of the data depends on dwOpcode. Can be NULL if the dwOpcode
does not require any input data.
ppOutData
Data passed back to the caller, as a result of the operation.
Can be set to NULL if no data are passed back.
Return Value
ABS_STATUS
Result code. ABS_STATUS_OK (0) means success.
