WFDOpenLegacySession-Funktion (wlanapi.h)

Artikel
12/22/2023

Die WFDOpenLegacySession-Funktion ruft ein gespeichertes Profil für ein Wi-Fi Direct-Legacygerät ab und wendet es an.

Syntax

DWORD WFDOpenLegacySession(
  HANDLE             hClientHandle,
  PDOT11_MAC_ADDRESS pLegacyMacAddress,
  HANDLE             *phSessionHandle,
  GUID               *pGuidSessionInterface
);

Parameter

hClientHandle

Ein HANDLE für den Wi-Fi Direct-Dienst für diese Sitzung. Dieser Parameter wird mithilfe der WFDOpenHandle-Funktion abgerufen.

pLegacyMacAddress

Ein Zeiger auf Wi-Fi direkte Geräteadresse des Legacyclientgeräts.

phSessionHandle

Ein Zeiger auf ein HANDLE , um das Handle zum Wi-Fi Direct-Dienst für diese Sitzung zu empfangen.

Wenn die WFDOpenLegacySession-Funktion erfolgreich ist, wird ein Handle für den Wi-Fi Direct-Dienst zurückgegeben, der in dieser Sitzung verwendet werden soll.

pGuidSessionInterface

Ein Zeiger auf die GUID der Netzwerkschnittstelle für diese Sitzung.

Wenn die WFDOpenLegacySession-Funktion erfolgreich ist, wird eine GUID der Netzwerkschnittstelle zurückgegeben, auf der Wi-Fi Direct-Sitzung zurückgegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	„Der Parameter ist falsch.“ Dieser Fehler wird zurückgegeben, wenn der Parameter phClientHandle oder pLegacyMacAddressNULL ist.
ERROR_NOT_ENOUGH_MEMORY	Für die Verarbeitung dieses Befehls ist nicht genügend Speicherplatz verfügbar. Dieser Fehler wird zurückgegeben, wenn das System nicht in der Lage war, Arbeitsspeicher zuzuweisen, um den Clientkontext zu erstellen.
RPC_STATUS	Verschiedene Fehlercodes.

Hinweise

Die WFDOpenLegacySession-Funktion ist Teil von Wi-Fi Direct, einem neuen Feature in Windows 8 und Windows Server 2012. Wi-Fi Direct basiert auf der Entwicklung der Wi-Fi Peer-to-Peer Technical Specification v1.1 der Wi-Fi Alliance (siehe wi-Fi Alliance Published Specifications). Das Ziel der Wi-Fi Peer-to-Peer Technical Specification besteht darin, eine Lösung für Wi-Fi Device-to-Device-Konnektivität bereitzustellen, ohne dass entweder ein Wireless Access Point (Wireless AP) zum Einrichten der Verbindung oder die Verwendung des vorhandenen Wi-Fi Adhoc-Mechanismus (IBSS) erforderlich ist.

Um Wi-Fi Direct verwenden zu können, muss eine Anwendung zunächst ein Handle für den Wi-Fi Direct-Dienst abrufen, indem sie die WFDOpenLegacySession - oder WFDOpenHandle-Funktion aufruft . Das Wi-Fi Direct-Handle (WFD), das von der WFDOpenHandle-Funktion zurückgegeben wird, wird für nachfolgende Aufrufe des Wi-Fi Direct-Diensts verwendet. Die WFDOpenLegacySession-Funktion wird verwendet, um ein gespeichertes Profil für ein Wi-Fi Direct-Legacygerät abzurufen und anzuwenden.

Die WFDOpenLegacySession-Funktion ruft das gespeicherte Legacyprofil für das Gerät aus dem Profilspeicher für die angegebene Legacygeräteadresse ab. Diese Geräteadresse muss von einem Geräteknoten abgerufen werden, der als Ergebnis der Posteingangskopplung (Legacy-WPS-Kopplung) erstellt wurde.

Sobald eine Anwendung den Wi-Fi Direct-Dienst verwendet, sollte die Anwendung die WFDCloseSession-Funktion aufrufen, um die Sitzung zu schließen, und die WFDCloseHandle-Funktion aufrufen, um dem Wi-Fi Direct-Dienst zu signalisieren, dass die Anwendung den Dienst verwendet. Dadurch kann der Wi-Fi Direct-Dienst ressourcen freigeben, die von der Anwendung verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wlanapi.h
Bibliothek	Wlanapi.lib
DLL	Wlanapi.dll