APISetFilterProp |
|
С помощью этой функции можно изменить параметры фильтра, связанные с тарификацией.
APISetFilterProp(FilterID, Enabled, Cost, BillEnabled)
Аргументы
FilterID
Строковое выражение, определяющее идентификатор фильтра - GUID или имя фильтра.
Enabled
Значение типа Boolean, определяющее состояние фильтра: true - фильтр разрешен, false - фильтр запрещен.
Cost
Стоимость трафика в % от тарифа, на прием. Целое положительное число. Отрицательное значение этого параметра игнорируется. Дробное значение округляется до целого.
BillEnabled
Значение типа Boolean, определяющее состояние опции Изменить стоимость трафика (закладка Действия): true - фильтр управляет тарификацией, false - фильтр тарификацией не управляет и значение стоимости трафика (параметр Cost) значения не имеет.
Замечание
Отметим, что присваивание параметру Enabled значения false отключает весь фильтр, а BillEnabled = false отключает только управление тарификацией. Поэтому для фильтров, которые кроме тарификации управляют также и доступом (тип На разрешение), логично использовать параметр BillEnabled в случае, когда сам трафик заданный фильтром запрещать не надо. Если надо манипулировать только одним параметром Enabled или BillEnabled, не изменяя другого, то их значения надо предварительно считать, вызвав функцию APIGetFilterProp.
Пример использования
Set Srv = CreateObject("TrafInsp.TrafInspAdmin")
APIPass = "123456" 'Пароль для доступа через API
Srv.APILogon(APIPass)
FilterID = "Besplatnyi" ' Имя фильтра
FilterData = Srv.APIGetFilterProp(FilterID) ' Возвращает параметры фильтра Besplatnyi
OldBillEnabled = FilterData(3)
OldCost = FilterData(4)
' Отключаем фильтр Besplatnyi без изменения его параметров
Srv.APISetFilterProp FilterID, False, OldCost, OldBillEnabled
Текущая страница справки: help.smart-soft.ru/index.html?apisetfilterprop.htm