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