ds_set()

Установить переменную сервера данных

Прототип:

#include <ds.h>
                                       
int ds_set( 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_set() передает данные variable_data на сервер данных dsdes. Сервер данных хранит эти данные в переменной variable_name, перезаписывая предыдущее ее значение.

Для отображения измененных данных на HTML странице используйте qnxvar с тегом read. Подробнее в slinger в Справочнике по утилитам.

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

0

Успешное завершение.

-1

Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EBADF

Некорректный файловый дескриптор dsdes.

ENOMEM

Недостаточно памяти для хранения данных.

ESRCH

Переменная отсутствует на сервере данных.

Примеры:

Обратитесь к slinger в Справочнике по утилитам.

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

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

Безопасность использования

Точка остановки потока

Да

Обработчик прерываний

Нет

Обработчик сигналов

Да

В потоке

Да

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

ds_create(), ds_flags(), ds_get()

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