Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |