функция обратного вызова WFD_OPEN_SESSION_COMPLETE_CALLBACK (wlanapi.h)

Статья
08/28/2023

Функция WFD_OPEN_SESSION_COMPLETE_CALLBACK определяет функцию обратного вызова, вызываемую функцией WFDStartOpenSession по завершении операции WFDStartOpenSession .

Синтаксис

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

Параметры

[in] hSessionHandle

Дескриптор сеанса Wi-Fi Direct. Это дескриптор сеанса, ранее возвращенный функцией WFDStartOpenSession .

[in] pvContext

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

[in] guidSessionInterface

GUID интерфейса локального сетевого интерфейса, на котором этот Wi-Fi устройство Direct имеет открытый сеанс. Этот параметр полезен, если протоколам более высокого уровня необходимо определить, к какому сетевому интерфейсу привязан сеанс Wi-Fi Direct. Это значение возвращается, только если параметр dwError ERROR_SUCCESS.

[in] dwError

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

Возможны следующие другие значения:

Значение	Значение
ERROR_INVALID_PARAMETER	Неправильный параметр". Эта ошибка возвращается, если параметр hClientHandle имеет значение NULL или недействителен.
ERROR_INVALID_STATE	Группа или ресурс не находится в правильном состоянии для выполнения запрошенной операции. Эта ошибка возвращается, если служба Wi-Fi Direct отключена групповой политикой в домене.
ERROR_SERVICE_NOT_ACTIVE	Служба не запущена. Эта ошибка возвращается, если служба автонастройки WLAN не запущена.
RPC_STATUS	Различные коды RPC и другие коды ошибок. Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

[in] dwReasonCode

Значение типа , указывающее более подробные сведения о том, произошла ли ошибка во время WFDStartOpenSession.

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

None

Remarks

Функция WFD_OPEN_SESSION_COMPLETE_CALLBACK является частью новой функции 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. После завершения асинхронной операции по подключению Wi-FI Direct вызывается функция обратного вызова, указанная в параметре pfnCallback .

Требования

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