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

Статья
03/04/2024

Функция WFDOpenHandle открывает дескриптор для службы Wi-Fi Direct и согласовывает версию API Wi-FI Direct для использования.

Синтаксис

DWORD WFDOpenHandle(
  [in]  DWORD   dwClientVersion,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

Параметры

[in] dwClientVersion

Самая высокая версия API Wi-Fi Direct, поддерживаемый клиентом.

Для Windows 8 и Windows Server 2012 этому параметру следует задать значение WFD_API_VERSION константы, определенной в файле заголовка Wlanapi.h.

[out] pdwNegotiatedVersion

Указатель на DWORD для полученной согласованной версии.

Если функция WFDOpenHandle выполнена успешно, возвращается версия, согласованная с Wi-Fi Direct Service, которая будет использоваться этим сеансом. Это значение обычно является самой высокой версией, поддерживаемой как клиентом, так и службой Wi-Fi Direct.

[out] phClientHandle

Указатель на HANDLE для получения дескриптора службы Wi-Fi Direct для этого сеанса.

При успешном выполнении функции WFDOpenHandle возвращается дескриптор для службы Wi-Fi Direct, используемой в этом сеансе.

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

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

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	Неправильный параметр". Эта ошибка возвращается, если параметр pdwNegotiatedVersion имеет значение NULL или параметр phClientHandle имеет значение NULL. Это значение также возвращается, если параметр dwClientVersion не равен WFD_API_VERSION.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно места для обработки этой команды. Эта ошибка возвращается, если системе не удалось выделить память для создания контекста клиента.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	Предпринята попытка установить сеанс на сетевом сервере, но для этого сервера уже установлено слишком много сеансов. Эта ошибка возвращается, если служба Wi-Fi Direct выдала слишком много дескрипторов.
RPC_STATUS	Различные коды ошибок.

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