WiFiDirectServiceAdvertiser Klasse

Definition

Namespace:

Windows.Devices.WiFiDirect.Services

Stellt einen Dienstinserenten dar. Diese Klasse wird von Code auf einem Gerät verwendet, das Wi-Fi Direct Services ankündigen, um den Dienst anzukündigen.

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

Vererbung

Object Platform::Object IInspectable WiFiDirectServiceAdvertiser

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Dies ist eine von mehreren Klassen, die das Verbinden von zwei Geräten mit einer Einstellung unterstützen, für die das Gerät der Gruppenbesitzer sein sollte. Im Thema Windows.Devices.WiFiDirect.Service erfahren Sie mehr über die Gerätekopplung und wie dies dazu führen kann, dass die Gruppenbesitzereinstellung ignoriert wird (und wie Sie dies beheben können.)

Der Dienstname wird im WiFiDirectServiceAdvertiser-Konstruktor festgelegt. Dienstnamen sind UTF-8-Zeichenfolgen, die nicht mehr als 255 Zeichen lang sind. Es wird empfohlen, dass Namen reverse Domänennamen-Notation verwenden, wobei der DNS-Name des Dienstbesitzers (z. B. "contoso.com") umgekehrt und als Anfang des Dienstnamens verwendet wird (z. B. "com.contoso.serviceX"). Diese Konvention soll die Auswahl eindeutiger Dienstnamen vereinfachen. Dienstnamen, die mit "org.wi-fi.wfds" beginnen, sind für die Verwendung durch die Wi-Fi Alliance reserviert, und Sie dürfen solche Namen nicht für Ihren Dienst verwenden.

Konstruktoren

WiFiDirectServiceAdvertiser(String)

Erstellt eine instance der WiFiDirectServiceAdvertiser-Klasse. Um mit der Werbung für einen Wi-Fi Direct Service zu beginnen, erstellen Sie eine instance dieser Klasse, legen die Eigenschaften entsprechend für Ihren Dienst fest, und rufen Sie dann die Start-Methode auf.

Eigenschaften

AdvertisementStatus	Ruft einen Wert ab, der die aktuelle status der Ankündigung beschreibt.
AutoAcceptSession	Ruft die Auto Accept-Eigenschaft für diese Dienstankündigung ab oder legt sie fest.
CustomServiceStatusCode	Ruft einen benutzerdefinierten Dienst status Code ab oder legt diese fest. Nur gültig, wenn der ServiceStatus-EigenschaftswertCustom ist.
DeferredSessionInfo	Ruft die dienstspezifischen Informationen ab, die beim Einrichten einer Sitzung an einen Sitzungsanforderunger übergeben werden, werden nicht sofort abgeschlossen, da der Dienst beispielsweise auf die Benutzereingabe wartet, um die Anforderung abzuschließen. Ein Anforderer sollte ein Timeout von 120 Sekunden implementieren, wenn seine Anforderung zurückgestellt wird.
PreferGroupOwnerMode	Ruft einen Wert ab, der angibt, ob der Dienst die Wi-Fi P2P-Gruppenbesitzer (Direct Peer to Peer) sein muss, oder legt diesen fest. Als Gruppenbesitzer kann der Dienst mehr Kontrolle über die P2P-Verbindungskonfiguration und den Verbindungsprozess ausüben. Ausführliche Informationen finden Sie in den Wi-Fi Direct P2P Technical Specifications(Technische Spezifikationen für Direct P2P), die von der Wi-Fi Alliance verfügbar sind.
PreferredConfigurationMethods	Ruft eine Liste (die die IVector-Schnittstelle implementiert) der bevorzugten Sitzungskonfigurationsmethoden ab. Ihr Code verwendet IVector-Vorgänge in der Liste, um Elemente hinzuzufügen oder aus der Liste zu entfernen.
ServiceError	Ruft einen bestimmten Fehlercode ab, wenn AdvertisementStatusabgebrochen wird.
ServiceInfo	Ruft das Dienstinformationsblob ab oder legt es fest. Das Format und der Inhalt des Blobs werden vom einzelnen Dienst bestimmt und sollen von Suchenden während der Dienstermittlung verwendet werden.
ServiceName	Ruft den Dienstnamen ab.
ServiceNamePrefixes	Ruft eine Liste von Dienstnamenpräfixen ab, die mit diesem Dienst übereinstimmen sollen, wenn ein Sucher präfixsuchend ist. Ihr Code verwendet IVector-Methoden zum Hinzufügen oder Entfernen von Elementen aus der Liste.
ServiceStatus	Ruft den dienst-status ab oder legt diese fest.

Methoden

ConnectAsync(DeviceInformation)	Akzeptiert eine Sitzungsanforderung, ohne dass eine PIN erforderlich ist.
ConnectAsync(DeviceInformation, String)	Akzeptiert eine Sitzungsanforderung, indem eine Verbindung mit der angegebenen PIN hergestellt wird.
Start()	Beginnt mit der Werbung für den Dienst, wobei aktuelle Eigenschaftswerte verwendet werden, um die Parameter der Ankündigung festzulegen.
Stop()	Beendet die Werbung für den Dienst. Dies wirkt sich nicht auf vorhandene Sitzungen aus, die mit dem Dienst verbunden sind.

Ereignisse

AdvertisementStatusChanged	Das Ereignis wird ausgelöst, wenn sich der Wert der AdvertisementStatus-Eigenschaft ändert.
AutoAcceptSessionConnected	Ereignis ausgelöst, wenn der Dienst eine Sitzungsanforderung automatisch akzeptiert hat. Ihr Ereignishandler sollte Socketverbindungen für die Endpunktpaare einrichten, die im Ereignisargumentobjekt aufgeführt sind.
SessionRequested	Ereignis ausgelöst, wenn ein Seeker angefordert hat, dass eine Sitzung mit dem Dienst eingerichtet wird, der diesem WiFiDirectServiceAdvertiser instance zugeordnet ist. Um die Anforderung anzunehmen, rufen Sie WiFiDirectServiceAdvertiser.ConnectAsync in Ihrem Ereignishandler auf.