Función WFDCloseSession (wlanapi.h)
La función WFDCloseSession cierra una sesión después de una llamada correcta previamente a la función WFDStartOpenSession .
Sintaxis
DWORD WFDCloseSession(
[in] HANDLE hSessionHandle
);
Parámetros
[in] hSessionHandle
Identificador de sesión de una sesión Wi-Fi sesión directa. Se trata de un identificador de sesión devuelto anteriormente por la función WFDStartOpenSession .
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 identificador no es válido.
Este error se devuelve si no se encontró el identificador especificado en el parámetro hSessionHandle en la tabla handle. |
|
El parámetro no es correcto.
Este error se devuelve si el parámetro hSessionHandle es NULL o no es válido. |
|
El grupo o recurso no está en el estado correcto para realizar la operación solicitada.
Este error se devuelve si la directiva de grupo de Wi-Fi servicio directo está deshabilitada por directiva de grupo en un dominio. |
|
Varios códigos de error. |
Comentarios
La función WFDCloseSession forma parte de Wi-Fi Direct, una nueva característica en Windows 8 y Windows Server 2012. Wi-Fi Direct se basa en el desarrollo del Wi-Fi especificación técnica punto a punto v1.1 de la Wi-Fi Alliance (consulte Especificaciones publicadas de Wi-Fi Alliance). El objetivo de la especificación técnica punto a punto de Wi-Fi es proporcionar una solución para Wi-Fi conectividad de dispositivo a dispositivo sin necesidad de un punto de acceso inalámbrico (AP inalámbrico) para configurar la conexión o el uso del mecanismo Wi-Fi adhoc (IBSS) existente.
La función WFDCloseSession pone en cola un elemento de trabajo futuro para cerrar la sesión, por lo que es posible que la desconexión no sea inmediata.
Al llamar a la función WFDCloseSession , mientras que una llamada WFDStartOpenSession está pendiente no cerrará la sesión.
Es responsabilidad del autor de la llamada pasar la función WFDCloseSession un identificador en el parámetro hSessionHandle que se devolvió de una llamada asincrónica correcta a la función WFDStartOpenSession .
Al llamar a la función WFDCloseSession con un identificador que era válido y que se ha convertido en no válido, se producirán resultados indefinidos.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wlanapi.h |
| Library | Wlanapi.lib |
| Archivo DLL | Wlanapi.dll |