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 WFDStartOpenSession-Funktion startet eine bedarfsgesteuerte Verbindung mit einem bestimmten Wi-Fi Direct-Gerät, das zuvor über die Windows-Kopplung gekoppelt wurde.
Syntax
DWORD WFDStartOpenSession(
[in] HANDLE hClientHandle,
[in] PDOT11_MAC_ADDRESS pDeviceAddress,
[in, optional] PVOID pvContext,
[in] WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
[out] PHANDLE phSessionHandle
);
Parameter
[in] hClientHandle
Ein Clienthandle für den Wi-Fi Direct-Dienst. Dieses Handle wurde durch einen vorherigen Aufruf der WFDOpenHandle-Funktion abgerufen.
[in] pDeviceAddress
Ein Zeiger auf die Wi-Fi direkte Geräteadresse des Zielgeräts. Dies ist die MAC-Adresse des Zielgeräts Wi-Fi.
[in, optional] pvContext
Ein optionaler Kontextzeiger, der an die im pfnCallback-Parameter angegebene Rückruffunktion übergeben wird.
[in] pfnCallback
Ein Zeiger auf die Rückruffunktion, die aufgerufen werden soll, sobald die WFDStartOpenSession-Anforderung abgeschlossen ist.
[out] phSessionHandle
Ein Handle für diese spezifische Wi-Fi Direct-Sitzung.
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 |
|---|---|
|
Das Handle ist ungültig.
Dieser Fehler wird zurückgegeben, wenn das im hClientHandle-Parameter angegebene Handle in der Handletabelle nicht gefunden wurde. |
|
„Der Parameter ist falsch.“
Dieser Fehler wird zurückgegeben, wenn der hClientHandle-ParameterNULL oder ungültig ist. Dieser Fehler wird auch zurückgegeben, wenn der pDeviceAddress-ParameterNULL, der pfnCallback-ParameterNULL oder der parameter phSessionHandleNULL ist. Dieser Wert wird auch zurückgegeben, wenn der dwClientVersion-Parameter nicht gleich WFD_API_VERSION ist. |
|
Die Gruppe oder Ressource befindet sich nicht im richtigen Zustand, um den angeforderten Vorgang durchzuführen.
Dieser Fehler wird zurückgegeben, wenn der Wi-Fi Direct-Dienst durch eine Gruppenrichtlinie für eine Domäne deaktiviert wird. |
|
Der Dienst wurde nicht gestartet.
Dieser Fehler wird zurückgegeben, wenn der WLAN AutoConfig-Dienst nicht ausgeführt wird. |
|
Verschiedene Fehlercodes. |
Hinweise
Die WFDStartOpenSession-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.
Die WFDStartOpenSession-Funktion startet einen asynchronen Vorgang, um eine bedarfsgesteuerte Verbindung mit einem bestimmten Wi-Fi Direct-Gerät zu starten. Das Ziel Wi-Fi Gerät muss zuvor über die Windows-Kopplung gekoppelt worden sein. Wenn der asynchrone Vorgang abgeschlossen ist, wird die im pfnCallback-Parameter angegebene Rückruffunktion aufgerufen.
Wenn die Anwendung versucht, das Handle für den Wi-Fi Direct-Dienst durch Aufrufen der WFDCloseHandle-Funktion zu schließen, bevor die WFDStartOpenSession-Funktion asynchron abgeschlossen wird, wartet die WFDCloseHandle-Funktion , bis der WFDStartOpenSession-Aufruf abgeschlossen ist.
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 |