Записывает значения атрибутов оповещений элементов точек данных, для которых оповещения были добавлены в базу данных к текстовым переменным. |
Краткое описание
int alertGetPeriod(time t1, time t2, dyn_time ×, dyn_int &counts, string alert1, dyn_string &dpa1, <dyn_type1> &vala1 [, string alert2, dyn_string &dpa2, <dyn_type2> &vala2 …]); |
Параметры
Параметр | Значение |
t1, t2 | Время начала и окончания |
times | Время оповещений (поле) |
counts | Счетчик оповещений для одного атрибута точки данных (поле) |
alert1, alert2, … | Атрибуты оповещений |
dpa1, dpa2, … | Текстовые поля |
vala1, vala2, … | Текстовые переменные базы данных |
Возвращаемое значение
Возвращает 0. В случае ошибки возвращает -1. |
Ошибка
ОшибкиОшибки можно вывести с помощью getLastError(). Возвращаемым значением getLastError() в таком случае является соответствующий код ошибки. Оповещение выдается в случае несуществующих точек данных, передачи неверных параметров или орфографических ошибок. |
Описание
Функция alertGetPeriod() осуществляет запись значений атрибутов оповещения alert1, alert2, а также других элементов точки данных, для которых в базу данных были добавлены оповещения во временных точках t1 и t2 из базы данных в поле «vala1», «vala2» и других переменных. Имена элементов записываются вместе с атрибутами (в виде «dpName.dpElem.[dpElem, … ]:dpKonfig.[dpDetail].dpAttr») в поля dpa1, dpa2 и далее. Соответствующее время оповещений записывается в поле времени. Счетчики для оповещений точки одного атрибута точки данных одним временем оповещения сохраняются в поле счетчика.Если для запроса используется псевдоним, это передается в качестве параметра в функцию внешнего запроса; функция вызывает dpQuery() и alertGetPeriod(). |
Поля времени, счетчиков, dpa1, vala1and т.д. имеют одинаковую длину. Элементы с тем же индексом принадлежат к тому же оповещению. Поля повторно инициализируются при каждом вызове, то есть они всегда имеют текущую длину. |
Вместо аргументов, таких как alert1, alert2, могут использоваться только атрибуты обработки оповещений отдельных переменных точек данных или имена атрибутов. Последнее относится ко всем переменным точек данных. |
Однако в рамках вызова dpGetPeriod() могут быть получены только различные атрибуты обработки всех переменных точек данных, либо только различные атрибуты обработки оповещений одной переменной. Обратите внимание: только те атрибуты обработки оповещений, для которых возможно выполнение функции alertConnect() (see _alert_hdl), могут занимать место alert1, alert2 и так далее. ПРИМЕЧАНИЕ Запрос истории атрибутов всех элементов точек данных элемента точки данных не поддерживается. ПРИМЕЧАНИЕ При использовании alertGetPeriod(), для РБД должны быть указаны имена точек данных, иначе произойдет ошибка. |
ПРИМЕР |
В этом примере присваиваются приоритеты оповещений всех переменных точек данных между пятым и шестым марта 1996 года, в 00:00 часов, в поле «prioo» и текстов оповещений в поле «texto». Соответствующие адреса атрибутов сохраняются в полях «prionamo» и «textnamo», а время оповещений сохраняется в поле «meldzeito». |
main(){ dyn_time meldzeito, meldzeitu;dyn_int zaehlo, prioo, zaehlu, priou;dyn_string prionamo, textnamo, texto;dyn_string prionamu, textnamu, textu;alertGetPeriod(setTime(t1,1996,3,5),setTime(t2,1996,3,6), meldzeito, zaehlo,»:_alert_hdl.._prior», prionamo, prioo,»:_alert_hdl.._text», textnamo, texto);} |
В нижеуказанном примере кода присваиваются приоритеты оповещений переменных точек данных «Valve17.circulation» между пятым и шестым марта 1996 года, в 00:00 часов, в поле «priou» и текстов оповещений в поле «textu». Соответствующие адреса атрибутов сохраняются в полях «prionamu» и «textnamu», а время оповещений сохраняется в поле «meldzeitu». |
main() { dyn_time meldzeito, meldzeitu; dyn_int zaehlo, prioo, zaehlu, priou; dyn_string prionamo, textnamo, texto; dyn_string prionamu, textnamu, textu; alertGetPeriod(setTime(t1,1996,3,5), setTime(t2,1996,3,6), meldzeito, zaehlo, «:_alert_hdl.._prior», prionamo, prioo, «:_alert_hdl.._text», textnamo, texto); } |
Используется для объекта
Обработка оповещений, управляющая функция ожидания |
Доступность
CTRL |
См. также