Share via

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

  • Статья

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

Синтаксис

DWORD WlanCloseHandle(
  [in] HANDLE hClientHandle,
       PVOID  pReserved
);

Параметры

[in] hClientHandle

Дескриптор сеанса клиента, который определяет соединение, которое необходимо закрыть. Этот дескриптор был получен при предыдущем вызове функции WlanOpenHandle .

pReserved

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

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

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

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

Код возврата Описание
ERROR_INVALID_PARAMETER
 hClientHandle имеет значение NULL или недопустимо, или pReserved не равно NULL.
ERROR_INVALID_HANDLE
 Дескриптор hClientHandle не найден в таблице дескрипторов.
RPC_STATUS
 Различные коды ошибок.

Комментарии

После закрытия подключения любая попытка использования закрытого дескриптора может привести к непредвиденным ошибкам. После закрытия все невыполненные уведомления удаляются.

Не вызывайте WlanCloseHandle из функции обратного вызова. Если клиент находится в середине обратного вызова уведомления при вызове WlanCloseHandle , функция ожидает завершения обратного вызова, прежде чем возвращать значение. Вызов этой функции внутри функции обратного вызова приведет к тому, что вызов никогда не завершится. Если функция обратного вызова и поток, закрывающий дескриптор, попытаются получить одну и ту же блокировку, может возникнуть взаимоблокировка. Кроме того, не вызывайте WlanCloseHandle из функции DllMain в библиотеке DLL приложения. Это также может привести к взаимоблокировки.

Требования

   
Минимальная версия клиента 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)

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

WlanOpenHandle