Función WlanHostedNetworkForceStart (wlanapi.h)
La función WlanHostedNetworkForceStart realiza la transición de la red hospedada inalámbrica al estado wlan_hosted_network_active sin asociar la solicitud con el identificador de llamada de la aplicación.
Sintaxis
DWORD WlanHostedNetworkForceStart(
[in] HANDLE hClientHandle,
[out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
PVOID pvReserved
);
Parámetros
[in] hClientHandle
El identificador de sesión del cliente, devuelto por una llamada anterior a la función WlanOpenHandle .
[out, optional] pFailReason
Puntero opcional a un valor que recibe el motivo del error si se produce un error en la llamada a la función WlanHostedNetworkForceStart . Los valores posibles para el motivo del error proceden del tipo de enumeración WLAN_HOSTED_NETWORK_REASON definido en el archivo de encabezado Wlanapi.h .
pvReserved
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 |
|---|---|
|
El autor de la llamada no tiene permisos suficientes. |
|
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. |
|
Un parámetro es incorrecto. Este error se devuelve si se produce alguna de las condiciones siguientes:
|
|
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 WlanHostedNetworkForceStart es una extensión de 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 WlanHostedNetworkForceStart para forzar el inicio de la red hospedada inalámbrica mediante la transición de la red hospedada inalámbrica al estado wlan_hosted_network_active sin asociar la solicitud con el identificador de llamada de la aplicación. Una llamada correcta a la función WlanHostedNetworkForceStart debe coincidir finalmente con una llamada a la función WlanHostedNetworkForceStop . Cualquier cambio de estado de red hospedado causado por esta función no 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.
El costo de llamar a la función WlanHostedNetworkForceStart a través de la llamada a WlanHostedNetworkStartUsing es el privilegio asociado necesario. Una aplicación podría llamar a la función WlanHostedNetworkForceStart después de asegurarse de que un usuario del sistema con privilegios elevados acepta los mayores requisitos de energía implicados en la ejecución de la red hospedada inalámbrica durante largos períodos.
La función WlanHostedNetworkForceStart podría producir un error si el estado de la red hospedada es wlan_hosted_network_unavailable o el autor de la llamada no tiene suficientes privilegios.
Esta función para forzar el inicio de la red hospedada solo se puede llamar si el usuario tiene el privilegio asociado adecuado. Los permisos se almacenan en una lista de control de acceso discrecional (DACL) asociada a un WLAN_SECURABLE_OBJECT. Para llamar a WlanHostedNetworkForceStart, el token de acceso de cliente del autor de la llamada debe tener privilegios elevados expuestos por la siguiente enumeración en WLAN_SECURABLE_OBJECT:
- wlan_secure_hosted_network_elevated_access
La capacidad de habilitar la red hospedada inalámbrica también puede estar restringida por la directiva de grupo en un dominio.
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