HTTP.GetConnectionState

table HTTP.GetConnectionState ( )
Примеры

Описание

Возвращает состояние подключения локальной системы.

Примечание: Этому действию требуется чтобы у конечного пользователя был установлен браузер Internet Explorer версии 4.0 или выше.

Примечание: Нельзя полагаться исключительно на тот факт, что параметр Connected в результате действия HTTP.GetConnectionState возвращает значение истина - true, означающее что имеется действующее активное подключение к Интернету. Для действия HTTP.GetConnectionState невозможно определить полностью ли работает подключение к Интернету, без отправки запроса на сервер. Именно поэтому нужно отправить запрос для определения, существует ли действительно подключение или нет. Тем не менее можно быть уверенным, что если параметр Connected действия HTTP.GetConnectionState возвращает значение истина - true, попытка подключения НЕ вызовет предложения подключиться к интернет провайдеру (Internet Service Provider) по умолчанию.

Параметры

Нет.

Возврат

ResultVariable

(таблица) Таблица, содержащая данные Интернет-соединения пользователя, индексированная следующими категориями:

Примечание: Если у пользователя имеется версия браузера Internet Explorer менее чем 4.0, будет возвращено значение nil.

КЛЮЧ
KEY
ТИП
TYPE
ОПИСАНИЕ
DESCRIPTION
ConnectedлогическийПодключен ли компьютер пользователя к Интернету. Если соединение есть, возвращается значение истина - true. Если соединения нет, возвращается ложь - false. К этому значению можно обратится как к tb.Connected.
ModemлогическийИспользует или нет локальная система модем для соединения с Интернет. Если модем используется, возвращается значение истина - true. Если модем не используется, возвращается ложь - false. К этому значению можно обратится как к tb.Modem.
LANлогическийИспользует или нет локальная система локальную сеть для соединения с Интернет. Если LAN используется, возвращается значение истина - true. Если LAN не используется, возвращается ложь - false. К этому значению можно обратится как к tb.Lan.
ProxyлогическийИспользует или нет локальная система прокси-сервер для соединения с Интернет. Если прокси-сервер используется, возвращается значение истина - true. Если прокси-сервер не используется, возвращается ложь - false. К этому значению можно обратится как к tb.Proxy.
RASInstalledлогическийУстановлена или нет в локальной системе служба RAS (Remote Access Service - Служба удаленного доступа). Если RAS установлена, возвращается значение истина - true. Если RAS не установлена, возвращается ложь - false. К этому значению можно обратится как к tb.RASInstalled.
ConnectionOfflineлогическийНаходится или нет локальная система в оффлайн (автономном) режиме. Если система в оффлайн режиме, возвращается значение истина - true. Если система не в оффлайн, возвращается ложь - false. К этому значению можно обратится как к tb.ConnectionOffline.
ConnectionConfiguredлогическийИмеет ли локальная система действующее подключение к Интернету, но соединение в настоящий момент может быть, а может и не быть. Если система имеет действующее подключение, возвращается значение истина - true. Если система не имеет действующего соединения, возвращается ложь - false. К этому значению можно обратится как к tb.ConnectionConfigured.

Можно использовать Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

При добавлении действия из редактора скрипта, можно использовать это поле для определения переменной, которая возвращает значение, сохраняющееся в ней.
Смотрите также: Связанные действия

Примеры

Пример 1

tConnectedState = HTTP.GetConnectionState();
Получаем состояние соединения и сохраняем его в таблице "tConnectedState".

Пример 2

-- Used to generate 100 spaces. This allows lining up of boolean values later
-- Используется для создания 100 знакомест. Позже это позволит выстроить линию из логических значений
function AddSpaces()
    strReturn = "";
    for nCount = 1, 100 do
        strReturn = strReturn .. " ";
    end
    return strReturn;
end

-- converts boolean value to string (true = True, false = False)
-- конвертируем логическое значение в строку (true = True, false = False)
function BoolToString(Value)
    if type (Value) == "boolean" then
        if Value then return "True" else return "False" end;
    else
        return Value;
    end
end

-- Get the current connection state
-- Получаем состояние текущего соединения
tConnectionState = HTTP.GetConnectionState();

-- Initialize string used to store the broken-down details
-- Инициализация строки, используемой для хранения отдельно взятых частей
strStateDetails = "";

-- traverse through tConnectionState, fill in string strStateDetails
-- проход через tConnectionState, заполняем строку strStateDetails
for sIndex, vDetails in pairs(tConnectionState) do
    strStateDetails = strStateDetails .. String.Mid(sIndex .. ": " .. AddSpaces(),1, 30) .. " " .. BoolToString(vDetails) .. "\r\n";
end

-- Output to user
-- Вывод пользователю
Dialog.Message("Connection State Results", strStateDetails);
Проверяем состояние соединения и выводим результаты пользователю.
Смотрите также: Связанные действия