Función WlanDisconnect (wlanapi.h)

La función WlanDisconnect desconecta una interfaz de su red actual.

Sintaxis

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

Parámetros

[in] hClientHandle

Identificador de sesión del cliente, obtenido por una llamada anterior a la función WlanOpenHandle .

[in] pInterfaceGuid

GUID de la interfaz que se va a desconectar.

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	hClientHandle es NULL o no es válido, pInterfaceGuid es NULL o pReserved no es NULL.
ERROR_INVALID_HANDLE	El identificador hClientHandle no se encontró en la tabla de identificadores.
RPC_STATUS	Varios códigos de error.
ERROR_NOT_ENOUGH_MEMORY	No se pudo asignar memoria para los resultados de la consulta.
ERROR_ACCESS_DENIED	El autor de la llamada no tiene permisos suficientes.

Observaciones

Cuando se estableció la conexión mediante WlanConnect, el miembro strProfile de la estructura de WLAN_CONNECTION_PARAMETERS apuntaba a pConnectionParameters. Si ese perfil era un perfil de usuario completo, el autor de la llamada WlanDisconnect debe tener acceso de ejecución en el perfil. De lo contrario, se producirá un error en la llamada a WlanDisconnect con el valor devuelto ERROR_ACCESS_DENIED. Los permisos de un perfil de usuario completo se establecen cuando se crea o guarda el perfil mediante WlanSetProfile o WlanSaveTemporaryProfile.

Para realizar una operación de desconexión en la línea de comandos, use el comando netsh wlan disconnect . Para obtener más información, consulta Netsh Commands for Wireless Local Area Network (wlan).

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: WlanDisconnect tiene el efecto secundario de modificar el perfil asociado a la red desconectada. Un perfil de red se convierte en un perfil a petición después de una llamada a WlanDisconnect . El servicio Wireless Zero Configuration no se conectará automáticamente a una red con un perfil a petición cuando la red esté dentro del intervalo. No llame a WlanDisconnect antes de llamar a WlanConnect a menos que desee cambiar un perfil a un perfil a petición. Cuando se llama a WlanConnect para establecer una conexión de red, cualquier conexión de red existente se quita automáticamente.

Requisitos

Cliente mínimo compatible	Windows Vista, Windows XP con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wlanapi.h (incluya Wlanapi.h)
Library	Wlanapi.lib
Archivo DLL	Wlanapi.dll
Redistribuible	API LAN inalámbrica para Windows XP con SP2

Consulte también

WlanConnect