Создает точку данных. Имена точек данных могут содержать только следующие символы: 0…9, A…Z, _, a…z. |
Краткое описание
int dpCreate(string dpname, string dptype [, int sysnum, unsigned dpNo]]); |
Параметры
Параметр | Значение |
. | Имя создаваемой точки данных |
dptype | Тип создаваемой точки данных |
sysnum | При создании точки данных на удаленной системе в распределенной системе, этот параметр должен содержать номер системы. |
dpNo | Идентификатор точки данных. Если точка данных с заданным идентификатором уже существует, выбирается случайный идентификатор. |
Возвращаемое значение
dpCreate() возвращает 0 при успехе и -1 при неудаче. В некоторых случаях функция возвращает 0 (успех), но, например из-за конфликта имени, точка данных не может быть создана. Информация об этом может быть запрошена с помощью getLastError(). |
Ошибка
Ошибки можно вывести при помощи getLastError(). Сюда входят неправильные или недостающие аргументы. |
Описание
Функция dpCreate() создает точку данных с именем dpname и типом точки данных dptype. Указанный тип точки данных уже должен существовать. Если точка данных с указанным именем уже существует, вызов функции dpCreate() не будет иметь результат. dpCreate() является функцией ожидания; она ожидает, пока не будет создана точка данных. |
Символы, которые не допускаются в именах точек данных: точка «.», двоеточие «:», точка с запятой «;», запятая «,», правые или левые квадратные скобки «[]», правые или левые фигурные скобки «{}», пробел, табуляция «/t», знак вопроса «?», звездочка «*», обратная косая черта «\», косая черта «/», знак процента «%», восклицательный знак «!», правые или левые скобки «()», символ доллара «$» и коммерческий символ «@». |
ПРИМЕР |
Создайте точку данных number_1 на основе типа точек данных ExampleDP_Int. Если точка данных уже существует, выдается сообщение. Далее создается точка данных под именем TestDP типа PUMP1 в системе с номером 2. |
main() { if (dpExists(«number_1»)) DebugN(«already exists»); else dpCreate(«number_1″,»ExampleDP_Int»); // Создание dpCreate(«TestDP», «PUMP1», 2); /*Создание точки данных в системе с номером 2*/ } |
Используется для объекта
Функция точки данных, Управляющие функции ожидания |
Доступность
UI, CTRL |
См. также