Функция WFDCancelOpenSession (wlanapi.h)
Функция WFDCancelOpenSession указывает, что приложение хочет отменить незавершенную функцию WFDStartOpenSession .
Синтаксис
DWORD WFDCancelOpenSession(
[in] HANDLE hSessionHandle
);
Параметры
[in] hSessionHandle
Дескриптор сеанса для отмены Wi-Fi прямого сеанса. Это дескриптор сеанса, ранее возвращенный функцией WFDStartOpenSession .
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.
| Код возврата | Описание |
|---|---|
|
Дескриптор недействителен.
Эта ошибка возвращается, если дескриптор, указанный в параметре hSessionHandle , не найден в таблице дескрипторов. |
|
Неправильный параметр".
Эта ошибка возвращается, если параметр hSessionHandle имеет значение NULL или недопустим. |
|
Различные коды ошибок. |
Комментарии
Функция 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 |