WiFiDirectService Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un servicio Wi-Fi Direct. El código usa esta clase en un dispositivo que busca usar un servicio directo Wi-Fi para establecer una sesión de servicio directo de Wi-Fi con el proveedor de servicios.
public ref class WiFiDirectService sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiDirectService final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiDirectService
Public NotInheritable Class WiFiDirectService
- Herencia
- Atributos
Requisitos de Windows
Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Comentarios
Se trata de una de varias clases que admiten la conexión de dos dispositivos con una preferencia por la que el dispositivo debe ser el propietario del grupo. Consulte el tema Windows.Devices.WiFiDirect.Service para obtener información sobre el emparejamiento de dispositivos y cómo puede hacer que se omita la preferencia del propietario del grupo (y cómo corregirlo).
El código no crea instancias de esta clase directamente. En su lugar, el código sigue este proceso para obtener una instancia de esta clase y usarla para establecer una sesión de servicio directo de Wi-Fi.
- Usar uno de los métodos GetSelector para obtener una cadena de consulta para un servicio determinado
- Cree un DeviceWatcher que busque anunciantes que coincidan con la cadena de consulta. Cuando se encuentra un anunciante, decida si desea usar ese anunciante, ya sea mediante programación o pidiendo al usuario que indique una opción.
- Una vez que el Solicitante haya identificado el anunciante del servicio deseado, llame al método estático FromIdAsync con el identificador de dispositivo del dispositivo de anunciante elegido. FromIdAsync recupera una instancia de WiFiDirectService para el servicio solicitado en el dispositivo solicitado.
- Continúe para establecer una sesión llamando a WiFiDirectService.ConnectAsync.
Propiedades
PreferGroupOwnerMode |
Obtiene o establece un valor que especifica si la instancia de servicio debe elegir Wi-Fi modo de propietario del grupo de punto a punto (P2P) (GO). |
RemoteServiceInfo |
Obtiene el blob de información de servicio de esta instancia de servicio. |
ServiceError |
Información de error sobre el intento más reciente de conectarse al servicio. |
SessionInfo |
Obtiene o establece la información de sesión específica de la aplicación que se pasa al servidor al iniciar una sesión. |
SupportedConfigurationMethods |
Obtiene una lista de métodos de configuración admitidos, ordenados por preferencia. El código usa operaciones IVector para modificar el contenido de la lista. |
Métodos
ConnectAsync() |
Inicia el establecimiento de una sesión de servicio con el servicio directo Wi-Fi representado por esta instancia. |
ConnectAsync(String) |
Inicia el establecimiento de una sesión de servicio con el servicio directo Wi-Fi representado por esta instancia, mediante un PIN para configurar la sesión. |
FromIdAsync(String) |
Método estático que recupera una instancia de WiFiDirectService para un servicio directo de Wi-Fi ofrecido por el dispositivo con un identificador de dispositivo determinado. |
GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod) |
Recupera de forma asincrónica Wi-Fi información de aprovisionamiento de sesiones de Direct Service. |
GetSelector(String) |
Obtiene una cadena de sintaxis de consulta avanzada (AQS) que se usará para buscar Wi-Fi anunciantes de Direct Service para un servicio determinado. |
GetSelector(String, IBuffer) |
Obtiene una cadena de sintaxis de consulta avanzada (AQS) que se va a usar para buscar Wi-Fi anunciantes de Direct Service para un servicio determinado, donde una secuencia de bytes determinada aparece en el blob de información de servicio del anunciante. |
Eventos
SessionDeferred |
Evento generado cuando se ha aplazado una solicitud de sesión. Tenga en cuenta que esto no significa que se haya producido un error en la solicitud o se haya denegado. Se trata de una notificación de que el servidor está realizando una operación larga, como esperar a que un usuario escriba un PIN. El solicitante que recibe este mensaje debe comenzar una espera de 120 segundos antes de que agote el tiempo de espera de la solicitud de sesión, para conceder al servidor tiempo para completar su operación. Los argumentos de evento incluyen un búfer proporcionado por el servidor en la notificación de aplazamiento con información adicional. |