Глобальный контекст.НачатьПолучениеИнформацииОСетевыхАдаптерах

Методы · BeginGettingNetworkAdaptersInformation

Процедура заполняет массив объектов типа ИнформацияОСетевомАдаптере и передает в функцию, указанную в обработчике <ОписаниеОповещения>.

Синтаксис

НачатьПолучениеИнформацииОСетевыхАдаптерах(<ОписаниеОповещения>)
Полное описание, параметры и ограничения

Глобальный контекст.НачатьПолучениеИнформацииОСетевыхАдаптерах (Global context.BeginGettingNetworkAdaptersInformation)

Глобальный контекст (Global context)

НачатьПолучениеИнформацииОСетевыхАдаптерах (BeginGettingNetworkAdaptersInformation)

Доступен, начиная с версии 8.3.18.

Синтаксис:
НачатьПолучениеИнформацииОСетевыхАдаптерах(<ОписаниеОповещения>)
Параметры:

<ОписаниеОповещения> (необязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения получения информации со следующими параметрами:
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

Возвращаемое значение:
Тип: Массив.
Массив объектов типа ИнформацияОСетевомАдаптере.
Описание:

Процедура заполняет массив объектов типа ИнформацияОСетевомАдаптере и передает в функцию, указанную в обработчике <ОписаниеОповещения>.

Доступность:

Тонкий клиент, веб-клиент, толстый клиент.

См. также:
Глобальный контекст, метод ПолучитьИнформациюОСетевыхАдаптерахАсинх

Использование в версии:

Доступен, начиная с версии 8.3.18.

Методическая информация

Практические примеры

Информация о сетевых адаптерах: массив и оповещение

Установленная справка объявляет возвращаемый массив и однопараметрический обработчик. Не добавляем в обработчик выдуманный второй параметр адаптеров.

Где и как запускать

Синтаксический пример в клиентском модуле своей управляемой формы. Полные процедуры вставляются в модуль; короткий фрагмент без процедуры — в тело клиентского обработчика. Здесь ничего не устанавливалось и не выполнялось. Только тонкий, веб- или толстый клиент, без мобильного клиента.

Подготовка

  1. В своей форме тонкого, веб- или толстого клиента предварительно подключите расширение получения информации о компьютере.

  2. Показываются только имена адаптеров своего учебного компьютера; не отправляйте сетевые сведения во внешние сервисы.

&НаКлиенте
Процедура ПосмотретьАдаптеры()
    Результат = Новый Структура("Адаптеры", Новый Массив);
    Оповещение = Новый ОписаниеОповещения("ПослеПолученияАдаптеров", ЭтотОбъект, Результат);
    Результат.Адаптеры = НачатьПолучениеИнформацииОСетевыхАдаптерах(Оповещение);
КонецПроцедуры
&НаКлиенте
Процедура ПослеПолученияАдаптеров(Результат) Экспорт
    Сообщить("Адаптеров: " + Строка(Результат.Адаптеры.Количество()));
    Для Каждого Адаптер Из Результат.Адаптеры Цикл
        Сообщить(Адаптер.ИмяАдаптера);
    КонецЦикла;
КонецПроцедуры

Разбор по шагам

  1. Создайте собственную структуру для заявленного возвращаемого массива.

  2. Начните получение и сохраните массив по сигнатуре справки.

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

Как проверить результат

  1. Обработчик имеет один параметр ДополнительныеПараметры, не пару Результат/ДополнительныеПараметры.

  2. Вывод основан на фактическом массиве; справка не обещает фиксированное число адаптеров.

Ожидаемый результат

Показан синтаксис для указанной подготовки. Здесь код не запускался; реальные результаты и побочные эффекты проверяются только при будущем осознанном выполнении в своём учебном приложении.

На что обратить внимание

  1. Справка одновременно называет метод процедурой, объявляет Массив в возвращаемом значении и описывает передачу массива обработчику, но в параметрах обработчика перечисляет только дополнительные параметры. Здесь показан заявленный синтаксис; момент готовности возвращаемого массива требует проверки на своей платформе.

  2. Не заменяйте отсутствие расширения фиктивным списком и не заявляйте получение аппаратных данных до завершения.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.