ds_get()

Получить значение переменной сервера данных

Прототип:

#include <ds.h>
int ds_get( ds_t dsdes,
const char *variable_name,
const char *variable_data,
size_t data_len );

Аргументы:

dsdes
Дескриптор сервера данных, возвращаемый ds_register().
variable_name
Имя переменной сервера данных, которую требуется получить.
variable_data
Область данных, где функция может хранить данные, связанные с переменной.
data_len
Размер области памяти в байтах.

Библиотека:

libds

Описание:

Функция ds_get() получает данные о variable_name из сервера данных dsdes, и помещает их в область памяти variable_data.

Возвращаемое значение:

Количество информации, записанное в буфер variable_data. Если возникла ошибка функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

EBADF
Некорректный файловый дескриптор dsdes.
EMSGSIZE
Область памяти недостаточна для помещения данных.
ESRCH
Переменная отсутствует на сервере данных.

Классификация:

ЗОСРВ «Нейтрино»

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

ds_create(), ds_set()




Предыдущий раздел: Описание API библиотеки ds