Соглашения о диагностике ошибок
Все функции LinAPI возвращают следующие коды завершения (см. таблицу 1 ):
Таблица 1. Коды завершения функций LinAPI
| Код завершения | Числовое значение | Описание |
|---|---|---|
LINAPI_SUCCESS
| 0 | В случае удачного завершения |
LINAPI_ERROR
| -1 | В случае внутренней ошибки |
LINAPI_INV_ID
| -2 | В случае передачи функции неверного идентификатора |
LINAPI_NO_MEM
| -3 | В случае недостатка оперативной памяти |
LINAPI_BUSY
| -4 | В случае попытки повторного обращения к какому-либо объекту LinAPI, если предыдущая операция по этому объекту не была завершена |
LINAPI_INV_CONTEXT
| -5 | В случае обнаружения ошибки во внутренних структурах |
LINAPI_ID_NUM_EXCEEDED
| -6 | В случае превышения максимального количества используемых идентификаторов |
Эти коды определены в заголовочном файле linapi.h.
Примечание
В случае удачного завершения возвращается 0 (LINAPI_SUCCESS). Если код завершения равен LINAPI_ERROR, то для получения диагностики работы библиотеки необходимо вызвать функцию LINTER_Error.