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


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

Функция WFDCloseHandle закрывает дескриптор для службы Wi-Fi Direct.

Синтаксис

DWORD WFDCloseHandle(
  [in] HANDLE hClientHandle
);

Параметры

[in] hClientHandle

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

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

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

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

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

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

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

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

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

Комментарии

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

Чтобы использовать Wi-Fi Direct, приложение должно сначала получить дескриптор для службы Wi-Fi Direct, вызвав функцию WFDOpenHandle . Дескриптор Wi-Fi Direct (WFD), возвращаемый функцией WFDOpenHandle , используется для последующих вызовов службы Wi-Fi Direct. После завершения работы приложения с помощью службы Wi-Fi Direct приложение должно вызвать функцию WFDCloseHandle , чтобы сообщить службе Wi-Fi Direct о том, что приложение выполняется с помощью этой службы. Это позволяет службе Wi-Fi Direct освобождать ресурсы, используемые приложением.

Требования

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

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

WFDCancelOpenSession

WFDCloseSession

WFDOpenHandle

WFDOpenLegacySession

WFDStartOpenSession

WFDUpdateDeviceVisibility

WFD_OPEN_SESSION_COMPLETE_CALLBACK