Функция WFDOpenLegacySession (wlanapi.h)
Функция WFDOpenLegacySession извлекает и применяет сохраненный профиль для устройства Wi-Fi Direct прежних версий.
Синтаксис
DWORD WFDOpenLegacySession(
HANDLE hClientHandle,
PDOT11_MAC_ADDRESS pLegacyMacAddress,
HANDLE *phSessionHandle,
GUID *pGuidSessionInterface
);
Параметры
hClientHandle
HANDLE для службы Wi-Fi Direct для этого сеанса. Этот параметр извлекается с помощью функции WFDOpenHandle .
pLegacyMacAddress
Указатель на Wi-Fi прямой адрес устройства устаревшего клиентского устройства.
phSessionHandle
Указатель на HANDLE для получения дескриптора Wi-Fi службы Direct для этого сеанса.
Если функция WFDOpenLegacySession выполнена успешно, возвращается дескриптор службы Wi-Fi Direct для использования в этом сеансе.
pGuidSessionInterface
Указатель на GUID сетевого интерфейса для этого сеанса.
Если функция WFDOpenLegacySession выполнена успешно, возвращается ИДЕНТИФИКАТОР GUID сетевого интерфейса, в котором Wi-Fi прямой сеанс.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.
| Код возврата | Описание |
|---|---|
|
Неправильный параметр".
Эта ошибка возвращается, если параметр phClientHandle или pLegacyMacAddress имеет значение NULL. |
|
Недостаточно места для обработки этой команды.
Эта ошибка возвращается, если системе не удалось выделить память для создания контекста клиента. |
|
Различные коды ошибок. |
Комментарии
Функция WFDOpenLegacySession является частью 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).
Чтобы использовать Wi-Fi Direct, приложение должно сначала получить дескриптор службы Wi-Fi Direct, вызвав функцию WFDOpenLegacySession или WFDOpenHandle . Дескриптор Wi-Fi Direct (WFD), возвращаемый функцией WFDOpenHandle , используется для последующих вызовов службы Wi-Fi Direct. Функция WFDOpenLegacySession используется для извлечения и применения сохраненного профиля для устройства Wi-Fi Direct прежних версий.
Функция WFDOpenLegacySession извлекает сохраненный устаревший профиль для устройства из хранилища профилей для указанного устаревшего адреса устройства. Этот адрес устройства должен быть получен из узла устройства, созданного в результате связывания папки "Входящие" (устаревшее связывание WPS).
После завершения работы приложения с помощью службы Wi-Fi Direct приложение должно вызвать функцию WFDCloseSession , чтобы закрыть сеанс, и вызвать функцию WFDCloseHandle , чтобы сообщить службе Wi-Fi Direct о том, что приложение выполняется с помощью этой службы. Это позволяет службе Wi-Fi Direct освобождать ресурсы, используемые приложением.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | wlanapi.h |
| Библиотека | Wlanapi.lib |
| DLL | Wlanapi.dll |