Función WFDCancelOpenSession (wlanapi.h)
La función WFDCancelOpenSession indica que la aplicación quiere cancelar una función WFDStartOpenSession pendiente que no se ha completado.
Sintaxis
DWORD WFDCancelOpenSession(
[in] HANDLE hSessionHandle
);
Parámetros
[in] hSessionHandle
Identificador de sesión para una sesión de Wi-Fi Direct que se va a cancelar. Se trata de un identificador de sesión devuelto previamente 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 de identificadores. |
|
El parámetro no es correcto.
Este error se devuelve si el parámetro hSessionHandle es NULL o no es válido. |
|
Varios códigos de error. |
Comentarios
La función WFDCancelOpenSession 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 de la especificación técnica punto a punto de Wi-Fi 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 existente adhoc (IBSS).
Una llamada a la función WFDCancelOpenSession notifica al servicio Wi-Fi Direct que el cliente solicita una cancelación de esta sesión. La función WFDCancelOpenSession no modifica el comportamiento de WFDStartOpenSession esperado. Se seguirá llamando a la función de devolución de llamada especificada en la función WFDStartOpenSession y es posible que la función WFDStartOpenSession no se complete inmediatamente.
Es responsabilidad del autor de la llamada pasar la función WFDCancelOpenSession un identificador en el parámetro hSessionHandle que se devolvió de la llamada a la función WFDStartOpenSession .
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 |