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

Статья
08/28/2023

Функция WFDStartOpenSession запускает подключение по запросу к определенному устройству Wi-Fi Direct, которое ранее было сопряжено через интерфейс связывания Windows.

Синтаксис

DWORD WFDStartOpenSession(
  [in]           HANDLE                             hClientHandle,
  [in]           PDOT11_MAC_ADDRESS                 pDeviceAddress,
  [in, optional] PVOID                              pvContext,
  [in]           WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
  [out]          PHANDLE                            phSessionHandle
);

Параметры

[in] hClientHandle

Клиентский дескриптор для службы Wi-Fi Direct. Этот дескриптор был получен при предыдущем вызове функции WFDOpenHandle .

[in] pDeviceAddress

Указатель на адрес Wi-Fi прямого устройства целевого устройства. Это MAC-адрес целевого Wi-Fi устройства.

[in, optional] pvContext

Необязательный указатель контекста, который передается в функцию обратного вызова, указанную в параметре pfnCallback .

[in] pfnCallback

Указатель на функцию обратного вызова, вызываемую после завершения запроса WFDStartOpenSession .

[out] phSessionHandle

Дескриптор этого конкретного сеанса Wi-Fi Direct.

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

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

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

Код возврата	Описание
ERROR_INVALID_HANDLE	Дескриптор недействителен. Эта ошибка возвращается, если дескриптор, указанный в параметре hClientHandle , не найден в таблице дескрипторов.
ERROR_INVALID_PARAMETER	Неправильный параметр". Эта ошибка возвращается, если параметр hClientHandle имеет значение NULL или недействителен. Эта ошибка также возвращается, если параметр pDeviceAddress имеет значение NULL, параметр pfnCallback имеет значение NULL или параметр phSessionHandle имеет значение NULL. Это значение также возвращается, если параметр dwClientVersion не равен WFD_API_VERSION.
ERROR_INVALID_STATE	Группа или ресурс не находится в правильном состоянии для выполнения запрошенной операции. Эта ошибка возвращается, если служба Wi-Fi Direct отключена групповой политикой в домене.
ERROR_SERVICE_NOT_ACTIVE	Служба не запущена. Эта ошибка возвращается, если служба автонастройки WLAN не запущена.
RPC_STATUS	Различные коды ошибок.

Функция WFDStartOpenSession является частью Wi-Fi Direct, новой функции в Windows 8 и Windows Server 2012. Wi-Fi Direct основан на разработке Wi-Fi одноранговой технической спецификации версии 1.1 Wi-Fi Alliance (см. опубликованные спецификации Wi-Fi Alliance). Целью технической спецификации Wi-Fi однорангового подключения является предоставление решения для Wi-Fi подключения между устройствами без необходимости в беспроводной точке доступа (беспроводной точке доступа) для настройки подключения или использовании существующего механизма Wi-Fi adhoc (IBSS).

Функция WFDStartOpenSession запускает асинхронную операцию для запуска подключения по запросу к определенному устройству Wi-Fi Direct. Целевой Wi-Fi устройство ранее должно быть сопряжено с помощью интерфейса связывания Windows. После завершения асинхронной операции вызывается функция обратного вызова, указанная в параметре pfnCallback .

Если приложение пытается закрыть дескриптор для службы Wi-Fi Direct путем вызова функции WFDCloseHandle до асинхронного завершения функции WFDStartOpenSession , функция WFDCloseHandle будет ожидать завершения вызова WFDStartOpenSession .

Требования

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