WFDOpenLegacySession-Funktion (wlanapi.h)
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 |
|---|---|
|
„Der Parameter ist falsch.“
Dieser Fehler wird zurückgegeben, wenn der Parameter phClientHandle oder pLegacyMacAddressNULL ist. |
|
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. |
|
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 |