Функция WlanHostedNetworkInitSettings (wlanapi.h)

Статья
08/28/2023

Функция WlanHostedNetworkInitSettings настраивает и сохраняет параметры сетевого подключения (например, SSID и максимальное число одноранговых узлов) в беспроводной размещенной сети, если эти параметры еще не настроены.

Синтаксис

DWORD WlanHostedNetworkInitSettings(
  [in]            HANDLE                      hClientHandle,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

Параметры

[in] hClientHandle

Дескриптор сеанса клиента, возвращенный предыдущим вызовом функции WlanOpenHandle .

[out, optional] pFailReason

Необязательный указатель на значение, которое получает причину сбоя при сбое вызова функции WlanHostedNetworkInitSettings . Возможные значения для причины сбоя относятся к типу перечисления WLAN_HOSTED_NETWORK_REASON , определенному в файле заголовка Wlanapi.h .

pvReserved

Зарезервировано для последующего использования. Этот параметр должен иметь значение NULL.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.

Код возврата	Описание
ERROR_INVALID_HANDLE	Недопустимый дескриптор. Эта ошибка возвращается, если дескриптор, указанный в параметре hClientHandle , не найден в таблице дескрипторов.
ERROR_INVALID_PARAMETER	Неправильный параметр. Эта ошибка возвращается при возникновении любого из следующих условий: hClientHandle имеет значение NULL. pvReserved не равно NULL.
ERROR_INVALID_STATE	Ресурс находится в неправильном состоянии для выполнения запрошенной операции.
ERROR_SERVICE_NOT_ACTIVE	Служба не запущена. Эта ошибка возвращается, если служба автонастройки WLAN не запущена.
Другое	Различные коды RPC и другие коды ошибок. Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

Функция WlanHostedNetworkInitSettings — это расширение собственных беспроводных API, добавленных для поддержки беспроводной сети в Windows 7 и Windows Server 2008 R2 с установленной службой беспроводной локальной сети.

Клиентское приложение вызывает функцию WlanHostedNetworkInitSettings для настройки и сохранения параметров сетевого подключения (например, SSID и максимального количества одноранговых узлов) в беспроводной размещенной сети, если параметры подключений еще не настроены. Если параметры сети в параметрах беспроводной размещенной сети уже настроены (функция WlanHostedNetworkQueryProperty не возвращает ERROR_BAD_CONFIGURATION для профиля станции или параметров подключения), то этот вызов функции возвращает ERROR_SUCCESS без изменения конфигурации сетевого подключения.

Клиентское приложение должно всегда вызывать функцию WlanHostedNetworkInitSettings , прежде чем использовать другие функции размещенной сети на локальном компьютере. Эта функция инициализирует параметры, необходимые при первом использовании беспроводной размещенной сети на локальном компьютере. Функция WlanHostedNetworkInitSettings не изменяет конфигурацию, если конфигурация уже сохранена. Поэтому можно безопасно вызывать функцию WlanHostedNetworkInitSettings , если конфигурация уже сохранена. Рекомендуется, чтобы приложения, использующие размещенную сеть, вызывали функцию WlanHostedNetworkInitSettings перед использованием других функций размещенной сети.

Функция WlanHostedNetworkInitSettings вычисляет случайный и доступный для чтения идентификатор SSID из имени узла и вычисляет случайный первичный ключ. Эта функция также использует значение для максимального допустимого числа одноранговых узлов, которое по умолчанию равно 100. Если приложению требуется использовать другой идентификатор SSID или другое максимальное число одноранговых узлов, приложение должно вызвать функцию WlanHostedNetworkSetProperty , чтобы задать эти свойства, используемые беспроводной размещенной сетью.

Любое изменение состояния размещенной сети, вызванное этой функцией, не будет автоматически отменено, если вызывающее приложение закрывает свой вызывающий дескриптор (путем вызова WlanCloseHandle с параметром hClientHandle ) или если процесс завершается.

Любой пользователь может вызвать функцию WlanHostedNetworkInitSettings для настройки и сохранения параметров подключения к сети хранилища в размещенной сети. Если беспроводная размещенная сеть уже настроена, эта функция не выполняет никаких действий и возвращает ERROR_SUCCESS.

В Windows 7 и более поздних версиях операционная система устанавливает виртуальное устройство, если на компьютере присутствует беспроводной адаптер с поддержкой размещенной сети. Это виртуальное устройство обычно отображается в папке "Сетевая Connections" как "Беспроводное сетевое подключение 2" с именем устройства "Microsoft Virtual WiFi Miniport adapter", если компьютер имеет один беспроводной сетевой адаптер. Это виртуальное устройство используется исключительно для выполнения подключений к точкам доступа программного обеспечения (SoftAP) и отсутствует в списке, возвращаемом функцией WlanEnumInterfaces . Время существования этого виртуального устройства привязано к физическому беспроводному адаптеру. Если физический беспроводной адаптер отключен, это виртуальное устройство также будет удалено. Эта функция также доступна в Windows Server 2008 R2 с установленной службой беспроводной локальной сети.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	wlanapi.h (включая Wlanapi.h)
Библиотека	Wlanapi.lib
DLL	Wlanapi.dll