WLAN_NOTIFICATION_CALLBACK Rückruffunktion (wlanapi.h)

Der Prototyp der WLAN_NOTIFICATION_CALLBACK Rückruffunktion definiert den Typ der Benachrichtigungsrückruffunktion.

Syntax

WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;

void WlanNotificationCallback(
  PWLAN_NOTIFICATION_DATA unnamedParam1,
  PVOID unnamedParam2
)
{...}

Parameter

unnamedParam1

Ein Zeiger auf eine WLAN_NOTIFICATION_DATA-Struktur , die die Benachrichtigungsinformationen enthält.

Windows XP mit SP3 und WLAN-API für Windows XP mit SP2: Nur die Benachrichtigungen wlan_notification_acm_connection_complete und wlan_notification_acm_disconnected sind verfügbar.

unnamedParam2

Ein Zeiger auf die Kontextinformationen, die der Client bei der Registrierung für die Benachrichtigung bereitgestellt hat.

Rückgabewert

Keine

Bemerkungen

Die WlanRegisterNotification-Funktion wird von einer Anwendung verwendet, um Benachrichtigungen auf allen Drahtlosschnittstellen zu registrieren und aufzuheben. Bei der Registrierung für Benachrichtigungen muss eine Anwendung eine Rückruffunktion bereitstellen, auf die der funcCallback-Parameter verweist, der an die WlanRegisterNotification-Funktion übergeben wird. Der Prototyp für diese Rückruffunktion ist die WLAN_NOTIFICATION_CALLBACK. Diese Rückruffunktion empfängt Benachrichtigungen, die im dwNotifSource-Parameter registriert wurden, die an die WlanRegisterNotification-Funktion übergeben werden.

Die Rückruffunktion wird mit einem Zeiger auf eine WLAN_NOTIFICATION_DATA-Struktur als ersten Parameter aufgerufen, der detaillierte Informationen zur Benachrichtigung enthält. Die Rückruffunktion empfängt auch einen zweiten Parameter, der einen Zeiger auf den Clientkontext enthält, der im pCallbackContext-Parameter an die WlanRegisterNotification-Funktion übergeben wird. Dieser Clientkontext kann ein NULL-Zeiger sein, wenn dieser an die WlanRegisterNotification-Funktion übergeben wurde.

Nach der Registrierung wird die Rückruffunktion aufgerufen, wenn eine Benachrichtigung verfügbar ist, bis der Client die Registrierung auf- oder schließt.

Jede Registrierung zum Empfangen von Benachrichtigungen wird automatisch rückgängig machen, wenn die aufrufende Anwendung ihr aufrufende Handle schließt (durch Aufrufen von WlanCloseHandle mit dem hClientHandle-Parameter ), das zum Registrieren von Benachrichtigungen mit der WlanRegisterNotification-Funktion verwendet wird, oder wenn der Prozess beendet wird.

Wenn das NotificationSource-Element der WLAN_NOTIFICATION_DATA Struktur, die von der Rückruffunktion empfangen wird , WLAN_NOTIFICATION_SOURCE_ACM ist, handelt es sich bei der empfangenen Benachrichtigung um eine Modulbenachrichtigung für die automatische Konfiguration. Das NotificationCode-Element der WLAN_NOTIFICATION_DATA-Struktur , die an die WLAN_NOTIFICATION_CALLBACK-Funktion übergeben wird, bestimmt die Interpretation des pData-MembersWLAN_NOTIFICATION_DATA Struktur. Weitere Informationen zu diesen Benachrichtigungen finden Sie unter WLAN_NOTIFICATION_ACM Enumerationsreferenz.

Wenn das NotificationSource-Mitglied der WLAN_NOTIFICATION_DATA Struktur, die von der Rückruffunktion empfangen wird , WLAN_NOTIFICATION_SOURCE_HNWK ist, handelt es sich bei der empfangenen Benachrichtigung um eine drahtlos gehostete Netzwerkbenachrichtigung, die unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst unterstützt wird. Das NotificationCode-Element der WLAN_NOTIFICATION_DATA-Struktur , die an die WLAN_NOTIFICATION_CALLBACK-Funktion übergeben wird, bestimmt die Interpretation des pData-MembersWLAN_NOTIFICATION_DATA Struktur. Weitere Informationen zu diesen Benachrichtigungen finden Sie unter WLAN_HOSTED_NETWORK_NOTIFICATION_CODE Enumerationsreferenz.

Wenn das NotificationSource-Element der WLAN_NOTIFICATION_DATA Struktur, die von der Rückruffunktion empfangen wird , WLAN_NOTIFICATION_SOURCE_IHV ist, handelt es sich bei der empfangenen Benachrichtigung um eine Benachrichtigung des unabhängigen Hardwareanbieters (Independent Hardware Vendor, IHV). Das NotificationCode-Element der WLAN_NOTIFICATION_DATA-Struktur , die an die WLAN_NOTIFICATION_CALLBACK-Funktion übergeben wird, bestimmt die Interpretation des pData-MembersWLAN_NOTIFICATION_DATA-Struktur , die für den IHV spezifisch ist.

Wenn das NotificationSource-Element der WLAN_NOTIFICATION_DATA Struktur, die von der Rückruffunktion empfangen wird , WLAN_NOTIFICATION_SOURCE_ONEX ist, handelt es sich bei der empfangenen Benachrichtigung um eine 802.1X-Modulbenachrichtigung. Das NotificationCode-Element der WLAN_NOTIFICATION_DATA-Struktur , die an die WLAN_NOTIFICATION_CALLBACK-Funktion übergeben wird, bestimmt die Interpretation des pData-MembersWLAN_NOTIFICATION_DATA Struktur. Weitere Informationen zu diesen Benachrichtigungen finden Sie unter ONEX_NOTIFICATION_TYPE Enumerationsreferenz.

Wenn das NotificationSource-Element der WLAN_NOTIFICATION_DATA Struktur, die von der Rückruffunktion empfangen wird , WLAN_NOTIFICATION_SOURCE_MSM ist, ist die empfangene Benachrichtigung eine medienspezifische Modulbenachrichtigung (MSM). Das NotificationCode-Element der WLAN_NOTIFICATION_DATA-Struktur , die an die WLAN_NOTIFICATION_CALLBACK-Funktion übergeben wird, bestimmt die Interpretation des pData-MembersWLAN_NOTIFICATION_DATA Struktur. Weitere Informationen zu diesen Benachrichtigungen finden Sie unter WLAN_NOTIFICATION_MSM Enumerationsreferenz.

Wenn das NotificationSource-Element der WLAN_NOTIFICATION_DATA Struktur, die von der Rückruffunktion empfangen wird , WLAN_NOTIFICATION_SOURCE_SECURITY ist, handelt es sich bei der empfangenen Benachrichtigung um eine Sicherheitsbenachrichtigung. Für WLAN_NOTIFICATION_SOURCE_SECURITY sind derzeit keine Benachrichtigungen definiert.

Windows XP mit SP3 und WLAN-API für Windows XP mit SP2: Benachrichtigungen werden vom Netman-Dienst verarbeitet. Wenn der Netman-Dienst deaktiviert oder nicht verfügbar ist, werden keine Benachrichtigungen empfangen. Wenn eine Benachrichtigung nicht innerhalb eines angemessenen Zeitraums empfangen wird, sollte eine Anwendung ein Timeout ausführen und den aktuellen Schnittstellenstatus abfragen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wlanapi.h
Verteilbare Komponente Wlan-API für Windows XP mit SP2

Weitere Informationen

ONEX_NOTIFICATION_TYPE

WLAN_HOSTED_NETWORK_NOTIFICATION_CODE

WLAN_NOTIFICATION_ACM

WLAN_NOTIFICATION_DATA

WLAN_NOTIFICATION_MSM

WlanRegisterNotification