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

Функция WlanOpenHandle открывает подключение к серверу.

Синтаксис

DWORD WlanOpenHandle(
  [in]  DWORD   dwClientVersion,
        PVOID   pReserved,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

Параметры

[in] dwClientVersion

Самая высокая версия API WLAN, которую поддерживает клиент.

Значение	Значение
1	Версия клиента для Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).
2	Версия клиента для Windows Vista и Windows Server 2008

pReserved

Зарезервировано для последующего использования. Для параметра должно быть задано значение NULL.

[out] pdwNegotiatedVersion

Версия API WLAN, которая будет использоваться в этом сеансе. Обычно это значение является самой высокой версией, поддерживаемой как клиентом, так и сервером.

[out] phClientHandle

Дескриптор, используемый клиентом в этом сеансе. Этот дескриптор используется другими функциями на протяжении всего сеанса.

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

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

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	pdwNegotiatedVersion имеет значение NULL, phClientHandle — NULL, или pReserved — не NULL.
ERROR_NOT_ENOUGH_MEMORY	Не удалось выделить память для создания контекста клиента.
RPC_STATUS	Различные коды ошибок.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	Сервер выпустил слишком много дескрипторов.

Комментарии

Номер версии, указанный dwClientVersion и pdwNegotiatedVersion , представляет собой составной номер версии, состоящий из основной и дополнительной версий. Основная версия указывается словом нижнего порядка, а вспоможенная версия — словом высокого порядка. Макросы WLAN_API_VERSION_MAJOR(_v) и WLAN_API_VERSION_MINOR(_v) возвращают основной и дополнительный номера версий соответственно. Номер версии можно создать с помощью макроса WLAN_API_MAKE_VERSION(_major, _minor).

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): WlanOpenHandle вернет сообщение об ошибке, если служба беспроводной нулевой конфигурации (WZC) не запущена или если служба WZC не отвечает.

Требования

Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wlanapi.h (включая Wlanapi.h)
Библиотека	Wlanapi.lib
DLL	Wlanapi.dll
Распространяемые компоненты	API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2)

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

WlanCloseHandle