Получение информации о БД – LINTER_ServerInfo
Прототип функции
L_LONG LINTER_ServerInfo(
L_CHAR *ServerName, /* имя сервера БД */
L_SWORD ServerNameLength, /* длина имени сервера БД */
L_SWORD InfoType, /* тип запрашиваемой информации */
void * Buffer, /* выходной буфер */
L_WORD BufferLength, /* размер выходного буфера */
L_WORD * OutLengthPtr, /* реальное количество байтов */
/* выходного буфера */
L_LONG * ApiCode, /* код завершения LinAPI */
L_LONG * LinCode, /* код завершения СУБД ЛИНТЕР */
L_LONG * SysCode); /* код завершения ОС */
Входные параметры
| Параметр | Описание | |
|---|---|---|
ServerName
| Имя сервера ЛИНТЕР. Если ServerName равен NULL, то запрос будет передан к локальному серверу | |
ServerNameLength
| Длина имени сервера. Если длина меньше или равна нулю, то ServerName должен заканчиваться двоичным нулем | |
InfoType
| Тип запрашиваемой информации | |
BufferLength
| Размер выходного буфера Buffer |
Выходные параметры
| Параметр | Описание | |
|---|---|---|
Buffer
| Выходной буфер | |
OutLengthPtr
| Реальное количество байт, записанных в буфер Buffer, или требуемый размер буфера (если произошла ошибка из-за недостаточно размера буфера) | |
ApiCode | Код завершения LinAPI, если функция вернула LINAPI_ERROR | |
LinCode | Код завершения СУБД, если функция вернула LINAPI_ERROR | |
SysCode
| Код завершения ОС, если функция вернула LINAPI_ERROR |
Описание
Помещает в буфер Buffer информацию о параметрах запрашиваемой БД в виде структуры t_DBDesc. Описание t_DBDesc приведено в пункте Соединение (Connect).
Примечание
В текущей реализации допустимо получение только одного типа запрашиваемой информации по идентификатору cDBDesc, который необходимо использовать в качестве значения для параметра InfoType.