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

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

  • Статья

Функция WlanDisconnect отключает интерфейс от текущей сети.

Синтаксис

DWORD WlanDisconnect(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
       PVOID      pReserved
);

Параметры

[in] hClientHandle

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

[in] pInterfaceGuid

ИДЕНТИФИКАТОР GUID отключаемого интерфейса.

pReserved

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

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

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

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

Код возврата Описание
ERROR_INVALID_PARAMETER
 hClientHandle имеет значение NULL или недопустимо, pInterfaceGuid имеет значение NULL, или pReserved не равно NULL.
ERROR_INVALID_HANDLE
 Дескриптор hClientHandle не найден в таблице дескрипторов.
RPC_STATUS
 Различные коды ошибок.
ERROR_NOT_ENOUGH_MEMORY
 Не удалось выделить память для результатов запроса.
ERROR_ACCESS_DENIED
 Вызывающий объект не имеет достаточных разрешений.

Комментарии

Когда подключение было установлено с помощью WlanConnect, профиль был указан членом strProfileструктуры WLAN_CONNECTION_PARAMETERS , на которую указывает pConnectionParameters. Если этот профиль был профилем всех пользователей, вызывающий объект WlanDisconnect должен иметь доступ к профилю на выполнение. В противном случае вызов WlanDisconnect завершится сбоем с возвращаемым значением ERROR_ACCESS_DENIED. Разрешения для профиля для всех пользователей устанавливаются при создании или сохранении профиля с помощью WlanSetProfile или WlanSaveTemporaryProfile.

Чтобы выполнить операцию отключения в командной строке, используйте команду netsh wlan disconnect . Дополнительные сведения см. в разделе Команды Netsh для беспроводной локальной сети (wlan).

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): WlanDisconnect имеет побочный эффект изменения профиля, связанного с отключенной сетью. Сетевой профиль становится профилем по запросу после вызова WlanDisconnect . Служба настройки беспроводной сети не будет автоматически подключаться к сети с профилем по запросу, когда сеть находится в диапазоне действия. Не вызывайте WlanDisconnect перед вызовом WlanConnect , если вы не хотите изменить профиль на профиль по запросу. При вызове WlanConnect для установки сетевого подключения все существующие сетевые подключения автоматически удаляются.

Требования

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

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

WlanConnect