WiFiDirectServiceAdvertiser Classe

Définition

Espace de noms:

Windows.Devices.WiFiDirect.Services

Représente un annonceur de service. Cette classe est utilisée par le code sur un appareil qui publie Wi-Fi Direct Services, pour publier le service.

public ref class WiFiDirectServiceAdvertiser sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WiFiDirectServiceAdvertiser final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WiFiDirectServiceAdvertiser

function WiFiDirectServiceAdvertiser(serviceName)

Public NotInheritable Class WiFiDirectServiceAdvertiser

Héritage

Object Platform::Object IInspectable WiFiDirectServiceAdvertiser

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Il s’agit de l’une des nombreuses classes qui prennent en charge la connexion de deux appareils avec une préférence pour lequel l’appareil doit être le propriétaire du groupe. Consultez la rubrique Windows.Devices.WiFiDirect.Service pour une présentation de l’appairage d’appareils et de la façon dont il peut entraîner l’ignorement de la préférence du propriétaire du groupe (et comment y remédier).

Le nom du service est défini dans le constructeur WiFiDirectServiceAdvertiser . Les noms de service sont des chaînes UTF-8 d’au plus 255 caractères. Il est recommandé que les noms utilisent une notation de nom de domaine inverse, où le nom DNS du propriétaire du service (par exemple, « contoso.com ») est inversé et utilisé comme début du nom du service (par exemple, « com.contoso.serviceX »). Cette convention est destinée à faciliter le choix de noms de service uniques. Les noms de service commençant par « org.wi-fi.wfds » sont réservés à l’utilisation par l’alliance Wi-Fi, et vous ne pouvez pas utiliser ces noms pour votre service.

Constructeurs

WiFiDirectServiceAdvertiser(String)

Crée un instance de la classe WiFiDirectServiceAdvertiser. Pour commencer à publier un service direct Wi-Fi, créez un instance de cette classe, définissez ses propriétés de manière appropriée pour votre service, puis appelez sa méthode Start.

Propriétés

AdvertisementStatus	Obtient une valeur qui décrit la status actuelle de la publicité.
AutoAcceptSession	Obtient ou définit la propriété Accept automatique pour cette publication de service.
CustomServiceStatusCode	Obtient ou définit un code status de service personnalisé. Valide uniquement si la valeur de la propriété ServiceStatus est Personnalisée.
DeferredSessionInfo	Obtient ou définit les informations spécifiques au service qui sont transmises à un demandeur de session lors de l’établissement d’une session ne sont pas terminées immédiatement, comme lorsque, par exemple, le service attend que l’entrée de l’utilisateur termine la demande. Un demandeur doit implémenter un délai d’expiration de 120 secondes lorsque sa demande est différée.
PreferGroupOwnerMode	Obtient ou définit une valeur indiquant si le service exige qu’il s’agisse du Wi-Fi propriétaire du groupe P2P (Direct Peer to Peer). Le fait d’être le propriétaire du groupe permet au service d’exercer un contrôle accru sur la configuration de la connexion P2P et le processus de connexion. Pour plus d’informations, consultez les spécifications techniques Wi-Fi Direct P2P, disponibles à partir de la Wi-Fi Alliance.
PreferredConfigurationMethods	Obtient une liste (qui implémente l’interface IVector ) des méthodes de configuration de session préférées. Votre code utilise des opérations IVector sur la liste pour ajouter ou supprimer des éléments de la liste.
ServiceError	Obtient un code d’erreur spécifique lorsque AdvertisementStatus est abandonné.
ServiceInfo	Obtient ou définit l’objet blob d’informations de service. Le format et le contenu de l’objet blob sont déterminés par le service individuel et sont destinés à être utilisés par les demandeurs lors de la découverte du service.
ServiceName	Obtient le nom du service.
ServiceNamePrefixes	Obtient la liste des préfixes de nom de service qui doivent correspondre à ce service lorsqu’un demandeur utilise la recherche de préfixes. Votre code utilise des méthodes IVector pour ajouter ou supprimer des éléments de la liste.
ServiceStatus	Obtient ou définit le status de service.

Méthodes

ConnectAsync(DeviceInformation)	Accepte une demande de session sans nécessiter de code confidentiel.
ConnectAsync(DeviceInformation, String)	Accepte une demande de session en se connectant avec le code confidentiel donné.
Start()	Commence à faire de la publicité pour le service, en utilisant les valeurs de propriété actuelles pour définir les paramètres de la publicité.
Stop()	Cesse de faire de la publicité pour le service. Cela n’affecte pas les sessions existantes connectées au service.

Événements

AdvertisementStatusChanged	Événement déclenché lorsque la valeur de la propriété AdvertisementStatus change.
AutoAcceptSessionConnected	Événement déclenché lorsque le service a accepté automatiquement une demande de session. Votre gestionnaire d’événements doit établir des connexions de socket pour les paires de points de terminaison répertoriées dans l’objet arguments d’événement.
SessionRequested	Événement déclenché lorsqu’un demandeur a demandé qu’une session soit établie avec le service associé à cette instance WiFiDirectServiceAdvertiser. Pour accepter la demande, appelez WiFiDirectServiceAdvertiser.ConnectAsync dans votre gestionnaire d’événements.