Función WlanRegisterVirtualStationNotification (wlanapi.h)
La función WlanRegisterVirtualStationNotification se usa para registrar y anular el registro de notificaciones en una estación virtual.
Sintaxis
DWORD WlanRegisterVirtualStationNotification(
[in] HANDLE hClientHandle,
[in] BOOL bRegister,
PVOID pReserved
);
Parámetros
[in] hClientHandle
Identificador de sesión del cliente, obtenido por una llamada anterior a la función WlanOpenHandle .
[in] bRegister
Valor que especifica si se deben recibir notificaciones en una estación virtual.
pReserved
Reservado para uso futuro. Este parámetro debe ser 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 |
|---|---|
|
Un parámetro es incorrecto. Este error se devuelve si se produce alguna de las condiciones siguientes:
|
|
Un identificador no es válido. Este error se devuelve si no se encontró el identificador especificado en el parámetro hClientHandle en la tabla handle. |
|
El recurso no está en el estado correcto para realizar la operación solicitada. Este error se devuelve si la red hospedada inalámbrica está deshabilitada por la directiva de grupo en un dominio. |
|
El servicio no se ha iniciado. Este error se devuelve si el servicio WLAN AutoConfig no se está ejecutando. |
|
Varios rpc y otros códigos de error. Use FormatMessage para obtener la cadena de mensaje para el error devuelto. |
Observaciones
La función WlanRegisterVirtualStationNotification es una extensión a las API inalámbricas nativas agregadas para admitir la red inalámbrica hospedada en Windows 7 y en Windows Server 2008 R2 con el servicio LAN inalámbrico instalado.
Una aplicación cliente llama a la función WlanRegisterVirtualStationNotification se usa para registrar y anular el registro de notificaciones en la estación virtual.
Cualquier registro para recibir notificaciones de una estación virtual causada por esta función se deshacería automáticamente si la aplicación que realiza la llamada cierra su identificador de llamada (llamando a WlanCloseHandle con el parámetro hClientHandle ) o si el proceso finaliza.
De forma predeterminada, un cliente de aplicación no recibirá notificaciones en una estación virtual. Para recibir estas notificaciones, un cliente debe llamar a la función WlanRegisterVirtualStationNotification con el parámetro bRegister establecido en TRUE y también debe llamar a la función WlanRegisterNotification con el parámetro dwNotifSource establecido en orígenes de notificación que se van a registrar. El registro para recibir notificaciones de una estación virtual está en vigor hasta que la aplicación cierra el identificador del cliente (llamando a WlanCloseHandle con el parámetro hClientHandle ), el proceso finaliza o se llama a la función WlanRegisterVirtualStationNotification con el parámetro bRegister establecido en FALSE.
En Windows 7 y versiones posteriores, el sistema operativo instala un dispositivo virtual si un adaptador inalámbrico compatible con red hospedada está presente en la máquina. Este dispositivo virtual aparece normalmente en la "Carpeta conexiones de red" como "Conexión de red inalámbrica 2" con un nombre de dispositivo de "Adaptador de miniporte de WiFi virtual de Microsoft" si el equipo tiene un único adaptador de red inalámbrica. Este dispositivo virtual se usa exclusivamente para realizar conexiones de punto de acceso de software (SoftAP) y no está presente en la lista devuelta por la función WlanEnumInterfaces . La duración de este dispositivo virtual está vinculada al adaptador inalámbrico físico. Si el adaptador inalámbrico físico está deshabilitado, este dispositivo virtual también se quitará. Esta característica también está disponible en Windows Server 2008 R2 con el servicio LAN inalámbrico instalado.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wlanapi.h (incluya Wlanapi.h) |
| Library | Wlanapi.lib |
| Archivo DLL | Wlanapi.dll |
Consulte también
Acerca de la red hospedada inalámbrica