WiFiDirectService Klasse

Referenz

Definition

Namespace:: Windows.Devices.WiFiDirect.Services

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt einen Wi-Fi Direct-Dienst dar. Diese Klasse wird von Code auf einem Gerät verwendet, das eine Wi-Fi Direct Service verwenden möchte, um eine Wi-Fi Direct Service-Sitzung mit dem Dienstanbieter einzurichten.

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

Vererbung: Object Platform::Object IInspectable WiFiDirectService

Attribute: 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 Präferenz unterstützen, für die das Gerät der Gruppenbesitzer sein sollte. Im Thema Windows.Devices.WiFiDirect.Service finden Sie eine Erläuterung der Gerätekopplung und wie dies dazu führen kann, dass die Gruppenbesitzerpräferenz ignoriert wird (und wie Sie dies beheben.)

Ihr Code instanziieren diese Klasse nicht direkt. Stattdessen folgt Ihr Code diesem Prozess, um eine instance dieser Klasse abzurufen und zum Einrichten einer Wi-Fi Direct Service-Sitzung zu verwenden.

Verwenden einer der GetSelector-Methoden zum Abrufen einer Abfragezeichenfolge für einen bestimmten Dienst
Erstellen Sie einen DeviceWatcher , der auf Inserenten überwacht, die mit der Abfragezeichenfolge übereinstimmen. Wenn ein Inserent gefunden wird, entscheiden Sie, ob dieser Advertiser verwendet werden soll, entweder programmgesteuert oder indem Sie den Benutzer bitten, eine Auswahl anzugeben.
Nachdem Ihr Seeker den gewünschten Dienstwerber identifiziert hat, rufen Sie die statische FromIdAsync-Methode mit der Geräte-ID des ausgewählten Inserentengeräts auf. FromIdAsync ruft eine instance von WiFiDirectService für den angeforderten Dienst auf dem angeforderten Gerät ab.
Fahren Sie mit dem Einrichten einer Sitzung fort, indem Sie WiFiDirectService.ConnectAsync aufrufen.

Eigenschaften

PreferGroupOwnerMode	Ruft einen Wert ab, der angibt, ob der Dienst instance Wi-Fi Gruppenbesitzermodus (P2P) auswählen soll, oder legt diesen fest.
RemoteServiceInfo	Ruft das Dienstinformationsblob aus diesem Dienst instance ab.
ServiceError	Fehlerinformationen zum letzten Versuch, eine Verbindung mit dem Dienst herzustellen.
SessionInfo	Ruft appspezifische Sitzungsinformationen ab, die beim Initiieren einer Sitzung an den Server übergeben werden, oder legt diese fest.
SupportedConfigurationMethods	Ruft eine Liste der unterstützten Konfigurationsmethoden nach Einstellung ab. Ihr Code verwendet IVector-Vorgänge , um den Inhalt der Liste zu ändern.

Methoden

ConnectAsync()	Initiiert die Einrichtung einer Dienstsitzung mit dem Wi-Fi Direct Service, der von diesem instance dargestellt wird.
ConnectAsync(String)	Initiiert die Einrichtung einer Dienstsitzung mit dem Wi-Fi Direct Service, der von diesem instance dargestellt wird, unter Verwendung einer PIN zum Konfigurieren der Sitzung.
FromIdAsync(String)	Statische Methode, die einen WiFiDirectService-instance für einen vom Gerät angebotenen Wi-Fi Direct Service mit einer bestimmten Geräte-ID abruft.
GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod)	Ruft asynchron Wi-Fi Informationen zur Bereitstellung von Direct Service-Sitzungen ab.
GetSelector(String)	Ruft eine AQS-Zeichenfolge (Advanced Query Syntax) ab, die verwendet werden soll, um Wi-Fi Direct Service-Inserenten für einen bestimmten Dienst zu suchen.
GetSelector(String, IBuffer)	Ruft eine AQS-Zeichenfolge (Advanced Query Syntax) ab, die verwendet wird, um Wi-Fi Direct Service-Inserenten für einen bestimmten Dienst zu suchen, wobei eine bestimmte Bytesequenz im Dienstinformationsblob des Inserenten angezeigt wird.

Ereignisse

SessionDeferred

Das Ereignis wird ausgelöst, wenn eine Sitzungsanforderung verzögert wurde. Beachten Sie, dass dies nicht bedeutet, dass die Anforderung fehlgeschlagen ist oder abgelehnt wurde. Es handelt sich um eine Benachrichtigung, dass der Server einen langen Vorgang ausführt, z. B. darauf wartet, dass ein Benutzer eine PIN eingibt. Der Sucher, der diese Nachricht empfängt, sollte eine 120-Sekunden-Wartezeit beginnen, bevor das Timeout der Sitzungsanforderung auftritt, um dem Server Zeit zum Abschließen des Vorgangs zu geben. Die Ereignisargumente enthalten einen Puffer, der vom Server in der Verzögerungsbenachrichtigung mit zusätzlichen Informationen bereitgestellt wird.

Gilt für:

Freigeben über