Richtlinien für Vorgänge vor der Zuordnung
Die DLL für IHV-Erweiterungen muss diese Richtlinien befolgen, wenn sie den Vorgang vor der Zuordnung ausführt.
Wenn die Dot11ExtIhvPerformPreAssociate-Funktion aufgerufen wird, muss die DLL für IHV-Erweiterungen folgendes ausführen:
- Überprüfen Sie die IHV-Erweiterungen für das Konnektivitäts- und Sicherheitsprofil. Wenn die Profilparameter ungültig sind, gibt die Dot11ExtIhvPerformPreAssociate-Funktion einen geeigneten Fehlercode zurück, wie in Winerror.h definiert.
- Erstellen Und starten Sie einen neuen Thread für den Abschluss des Vorgangs vor der Zuordnung. Da der Präzuordnungsvorgang asynchron über den Aufruf von Dot11ExtIhvPerformPreAssociate abgeschlossen werden muss, muss die DLL für IHV-Erweiterungen Dot11ExtPreAssociateCompletion aus diesem Thread aufrufen, nachdem der Vorgang abgeschlossen ist.
- Gibt ERROR_SUCCESS aus dem Funktionsaufruf zurück. An diesem Punkt wird das Betriebssystem benachrichtigt, dass das Netzwerkprofil gültig ist und der Vorzuordnungsvorgang ausgeführt wird.
Die DLL für IHV-Erweiterungen kann die Dot11ExtNicSpecificExtension-Funktion aufrufen, um den WLAN-Adapter zu konfigurieren. Diese Funktion kann entweder innerhalb des Aufrufs von Dot11ExtIhvPerformPreAssociate oder aus dem Thread aufgerufen werden, der den Vorgang vor der Zuordnung verarbeitet, nachdem Dot11ExtIhvPerformPreAssociate zurückgegeben wurde.
Aufrufe von Dot11ExtSetProfileCustomUserData, Dot11ExtGetProfileCustomUserData und Dot11ExtSetCurrentProfile dürfen nicht innerhalb des Aufrufs von Dot11ExtIhvPerformPreAssociate erfolgen. Diese Funktionen können nur aufgerufen werden , nachdem Dot11ExtIhvPerformPreAssociate ERROR_SUCCESS zurückgibt.
Nachdem die DLL für IHV-Erweiterungen Dot11ExtPreAssociateCompletion aufgerufen hat , um den Vorgang vor der Zuordnung abzuschließen, ist das Handle für die Verbindungssitzung nicht mehr gültig. Das Betriebssystem übergibt dieses Handle über den hConnectSession-Parameter von Dot11ExtIhvPerformPreAssociate. Die DLL darf diesen Handle-Wert nicht verwenden, wenn IHV-Erweiterbarkeitsfunktionen aufgerufen werden, die einen hConnectSession-Parameter deklarieren.
Weitere Informationen zu den IHV-Erweiterbarkeitsfunktionen finden Sie unter Native 802.11 IHV-Erweiterbarkeitsfunktionen.
Wenn die Dot11ExtIhvAdapterReset-Funktion aufgerufen wird, muss die IHV-Erweiterungen-DLL den Vorzuordnungsvorgang abbrechen, indem Dot11ExtPreAssociateCompletion aufgerufen wird. Weitere Informationen zum Zurücksetzen finden Sie unter Zurücksetzen des WLAN-Adapters 802.11.
Wenn die Dot11ExtIhvDeinitAdapter-Funktion aufgerufen wird, muss die IHV-Erweiterungs-DLL den Vorzuordnungsvorgang intern abbrechen. Es darf jedoch keine der IHV-Erweiterbarkeitsfunktionen aufrufen, die nur nach der Adapterinitialisierung aufgerufen werden können, einschließlich Dot11ExtPreAssociateCompletion.