WFD_OPEN_SESSION_COMPLETE_CALLBACK Rückruffunktion (wlanapi.h)

Artikel
12/22/2023

Die WFD_OPEN_SESSION_COMPLETE_CALLBACK-Funktion definiert die Rückruffunktion, die von der WFDStartOpenSession-Funktion aufgerufen wird, wenn der WFDStartOpenSession-Vorgang abgeschlossen ist.

Syntax

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

Parameter

[in] hSessionHandle

Ein Sitzungshandle für eine Wi-Fi Direct-Sitzung. Dies ist ein Sitzungshandle, das zuvor von der WFDStartOpenSession-Funktion zurückgegeben wurde.

[in] pvContext

Ein Kontextzeiger, der von der WFDStartOpenSession-Funktion an die Rückruffunktion übergeben wird.

[in] guidSessionInterface

Die Schnittstellen-GUID der lokalen Netzwerkschnittstelle, auf der dieses Wi-Fi Direct-Gerät eine geöffnete Sitzung hat. Dieser Parameter ist nützlich, wenn Protokolle mit höherer Ebene bestimmen müssen, an welche Netzwerkschnittstelle eine Wi-Fi Direct-Sitzung gebunden ist. Dieser Wert wird nur zurückgegeben, wenn der dwError-Parameter ERROR_SUCCESS ist.

[in] dwError

Ein -Wert, der angibt, ob während des Aufrufs der WFDStartOpenSession-Funktion ein Fehler aufgetreten ist. Wenn dieser Wert ERROR_SUCCESS ist, ist kein Fehler aufgetreten, und der Vorgang zum Öffnen der Sitzung wurde erfolgreich abgeschlossen.

Die folgenden anderen Werte sind möglich:

Wert	Bedeutung
ERROR_INVALID_PARAMETER	„Der Parameter ist falsch.“ Dieser Fehler wird zurückgegeben, wenn der hClientHandle-ParameterNULL oder ungültig ist.
ERROR_INVALID_STATE	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.
ERROR_SERVICE_NOT_ACTIVE	Der Dienst wurde nicht gestartet. Dieser Fehler wird zurückgegeben, wenn der WLAN AutoConfig-Dienst nicht ausgeführt wird.
RPC_STATUS	Verschiedene RPC- und andere Fehlercodes. Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

[in] dwReasonCode

Ein -Wert, der die ausführlicheren Angaben angibt, wenn während wfDStartOpenSession ein Fehler aufgetreten ist.

Rückgabewert

Keine

Bemerkungen

Die funktion WFD_OPEN_SESSION_COMPLETE_CALLBACK 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 zum Herstellen der Wi-FI Direct-Verbindung abgeschlossen wird, wird die im pfnCallback-Parameter angegebene Rückruffunktion aufgerufen.

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