Поделиться через


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

Функция WFDCloseSession закрывает сеанс после успешного вызова функции WFDStartOpenSession .

Синтаксис

DWORD WFDCloseSession(
  [in] HANDLE hSessionHandle
);

Параметры

[in] hSessionHandle

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

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

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

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

Код возврата Описание
ERROR_INVALID_HANDLE
Дескриптор недействителен.

Эта ошибка возвращается, если дескриптор, указанный в параметре hSessionHandle , не найден в таблице дескрипторов.

ERROR_INVALID_PARAMETER
Неправильный параметр".

Эта ошибка возвращается, если параметр hSessionHandle имеет значение NULL или недопустим.

ERROR_INVALID_STATE
Группа или ресурс не находится в правильном состоянии для выполнения запрошенной операции.

Эта ошибка возвращается, если служба Wi-Fi Direct отключена групповой политикой в домене.

RPC_STATUS
Различные коды ошибок.

Комментарии

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

Функция WFDCloseSession помещает в очередь будущий рабочий элемент для закрытия сеанса, поэтому отключение может не быть немедленным.

Вызов функции WFDCloseSession в ожидании вызова WFDStartOpenSession не приведет к закрытию сеанса.

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

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

Требования

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

См. также раздел

WFDCancelOpenSession

WFDCloseHandle

WFDOpenHandle

WFDOpenLegacySession

WFDStartOpenSession

WFDUpdateDeviceVisibility

WFD_OPEN_SESSION_COMPLETE_CALLBACK