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

Статья
12/22/2023

Функция WFDCancelOpenSession указывает, что приложение хочет отменить незавершенную функцию WFDStartOpenSession .

Синтаксис

DWORD WFDCancelOpenSession(
  [in] HANDLE hSessionHandle
);

Параметры

[in] hSessionHandle

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

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

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

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

Код возврата	Описание
ERROR_INVALID_HANDLE	Дескриптор недействителен. Эта ошибка возвращается, если дескриптор, указанный в параметре hSessionHandle , не найден в таблице дескрипторов.
ERROR_INVALID_PARAMETER	Неправильный параметр". Эта ошибка возвращается, если параметр hSessionHandle имеет значение NULL или недопустим.
RPC_STATUS	Различные коды ошибок.

Функция WFDCancelOpenSession является частью 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).

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

Вызывающий объект обязан передать функции WFDCancelOpenSession дескриптор в параметре hSessionHandle , который был возвращен из вызова функции WFDStartOpenSession .

Требования

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