DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur (windot11.h)
Wichtig
Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows-Treibermodell.
Die DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur gibt die Ergebnisse des Zuordnungsvorgangs an, der von der 802.11-Station mit einem Access Point (AP) oder einer Peerstation ausgeführt wird. Der Native 802.11-Miniporttreiber enthält eine DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur, wenn der Miniporttreiber eine NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION status-Anzeige gibt.
Syntax
typedef struct DOT11_ASSOCIATION_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS MacAddr;
DOT11_ASSOC_STATUS uStatus;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
ULONG uIHVDataOffset;
ULONG uIHVDataSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
BOOLEAN bFourAddressSupported;
BOOLEAN bPortAuthorized;
UCHAR ucActiveQoSProtocol;
DOT11_DS_INFO DSInfo;
ULONG uEncapTableOffset;
ULONG uEncapTableSize;
DOT11_CIPHER_ALGORITHM MulticastMgmtCipher;
ULONG uAssocComebackTime;
} DOT11_ASSOCIATION_COMPLETION_PARAMETERS, *PDOT11_ASSOCIATION_COMPLETION_PARAMETERS;
Member
Header
Der Typ, die Revision und die Größe der DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.
Der Miniporttreiber muss die Member von Header auf die folgenden Werte festlegen:
Typ
Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.
Revision
Dieser Member muss auf DOT11_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1 festgelegt werden.
Size
Dieses Element muss auf sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS)festgelegt werden.
Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.
MacAddr
Die MAC-Adresse (Media Access Control) des Access Point (AP) (für BSS-Infrastrukturnetzwerke) oder Peerstation (für unabhängige IBSS-Netzwerke), mit der die 802.11-Station eine Verbindung herstellen wollte.
uStatus
Der Abschluss status des Zuordnungsvorgangs, wie durch einen für DOT11_ASSOC_STATUS definierten Wert angegeben.
bReAssocReq
Ein boolescher Wert, der angibt, ob die 802.11-Station einen 802.11 Association- oder Reassociation-Frame an den AP gesendet hat. Wenn true, hat die 802.11-Station einen 801.11 Reassociation Request Frame an den AP gesendet. Bei FALSE hat die 802.11-Station einen 802.11-Zuordnungsanforderungsframe an den AP gesendet.
Ein True-Wert für das bReAssocReq-Element ist nur gültig, wenn das DOT11DesiredBSSType-MIB-Objekt auf dot11_BSS_type_infrastructure festgelegt ist.
bReAssocResp
Ein boolescher Wert, der angibt, ob die 802.11-Station einen 802.11 Association- oder Reassociation-Frame vom AP empfangen hat. Wenn TRUE, erhielt die 802.11-Station einen 802.11 Reassociation Response-Frame vom AP. Wenn FALSE, erhielt die 802.11-Station einen 802.11-Zuordnungsantwortrahmen vom AP.
Ein Wert von TRUE für das bReAssocResp-Element ist nur gültig, wenn das DOT11DesiredBSSType-MIB-Objekt auf dot11_BSS_type_infrastructure festgelegt ist.
uAssocReqOffset
Der Offset des Anforderungsrahmens, der im Zuordnungsvorgang verwendet wird. Der Frame enthält nicht den MAC-Header 802.11.
Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur enthält.
Der vom Miniporttreiber zurückgegebene Zuordnungsanforderungsframe hängt von der Einstellung des IEEE 802.11 dot11DesiredBSSType MIB-Objekts ab:
- Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_infrastructure festgelegt ist, ist der Frame entweder der 802.11 Association Request-Frame (wenn bReAssocReqFALSE ist) oder reassociation Request Frame (wenn bReAssocReqTRUE ist), der an den AP gesendet wurde. Der Miniporttreiber muss einen 802.11-Testanforderungsframe zurückgeben, der entweder vom Zuordnungsinitiator gesendet oder vom Treiber basierend auf Informationen erstellt wird, die während des Zuordnungsvorgangs ausgetauscht wurden.
- Wenn das DOT11DesiredBSSType-MIB-Objekt auf dot11_BSS_type_independent festgelegt ist, muss der Miniporttreiber den uAssocReqOffset-Member auf 0 festlegen.
Der Miniporttreiber muss die Mitglieder uAssocReqOffset und uAssocReqSize auf 0 festlegen, wenn er während des Zuordnungsvorgangs keinen Anforderungsrahmen senden konnte. Wenn der AP beispielsweise den 802.11-Authentifizierungsrahmen, der von der Station 802.11 gesendet wurde, nicht erfolgreich war, muss der Miniporttreiber uAssocReqOffset und uAssocReqSize auf Null festlegen.
uAssocReqSize
Die Länge des Anforderungsrahmens, der im Zuordnungsvorgang verwendet wird. Die Länge des Frames enthält nicht den MAC-Header 802.11.
Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_independent festgelegt ist, muss der Miniporttreiber den uAssocReqSize-Member auf 0 festlegen.
uAssocRespOffset
Der Offset des Antwortframes, der im Zuordnungsvorgang verwendet wird. Der Frame enthält nicht den MAC-Header 802.11.
Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur enthält.
Der vom Miniporttreiber zurückgegebene Zuordnungsantwortrahmen hängt von der Einstellung des IEEE 802.11 dot11DesiredBSSType MIB-Objekts ab:
Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_infrastructure festgelegt ist, ist der Frame entweder der 802.11-Zuordnungsantwortrahmen (wenn bReAssocReqTRUE ist) oder der Reassociation Response-Frame (wenn bReAssocReqFALSE ist), der vom AP empfangen wurde. Der Miniporttreiber muss einen 802.11-Testantwortframe zurückgeben, der entweder an den Zuordnungsinitiator gesendet oder vom Treiber basierend auf informationen erstellt wird, die während des Zuordnungsvorgangs ausgetauscht wurden.
Wenn das DOT11DesiredBSSType MIB-Objekt auf dot11_BSS_type_independent festgelegt ist, muss der Miniporttreiber den uAssocRespOffset-Member auf 0 festlegen.
Der Miniporttreiber muss die Mitglieder uAssocRespOffset und uAssocRespSize auf 0 festlegen, wenn er während des Zuordnungsvorgangs keinen Antwortframe empfangen hat.
uAssocRespSize
Die Länge des Antwortframes, der im Zuordnungsvorgang verwendet wird. Die Länge des Frames enthält nicht den MAC-Header 802.11.
Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_independent festgelegt ist, muss der Miniporttreiber den uAssocRespSize-Member auf 0 festlegen.
uBeaconOffset
Der Offset der zuletzt empfangenen 802.11 Beacon- oder Testantwortrahmen. Der Miniporttreiber muss den MAC-Header 802.11 für diese Frames ausschließen, wenn die NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION status Angezeigt wird.
Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur enthält.
Hinweis
Wenn der für die Zuordnung verwendete Authentifizierungsalgorithmus Wi-Fi Protected Access (WPA) oder IEEE 802.11i Robust Security Network Association (RSNA) war, muss der Miniporttreiber immer den letzten empfangenen 802.11 Beacon-Frame zurückgeben und darf die Mitglieder uBeaconOffset und uBeaconSize nicht auf null festlegen.
uBeaconSize
Die Länge des zuletzt empfangenen 802.11 Beacon-Frames. Die Länge des Frames enthält nicht den MAC-Header 802.11.
uIHVDataOffset
Der Offset eines Datenblocks in einem proprietären Format, das vom IHV definiert wird. Der IHV kann diesen Datenblock für alle Zwecke verwenden, die im Zusammenhang mit der NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION status Angabe stehen.
Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur enthält.
Wenn der Miniporttreiber keine IHV-Daten im NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION status-Anzeige zurückgibt, muss er uIHVDataOffset auf 0 festlegen.
uIHVDataSize
Die Länge des Datenblocks, der vom IHV für die NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION status Angabe verwendet wird. Wenn der Miniporttreiber in dieser Anzeige keine IHV-Daten zurückgibt, muss er uIHVDataSize auf Null festlegen.
AuthAlgo
Der Authentifizierungsalgorithmus, den die Station 802.11 während des Zuordnungsvorgangs mit dem AP oder der Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das AuthAlgo-Element finden Sie unter DOT11_AUTH_ALGORITHM.
Der Miniporttreiber muss diesen Member auf 0 festlegen, wenn uStatus nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt ist.
UnicastCipher
Der Unicast-Verschlüsselungsalgorithmus, den die Station 802.11 während des Zuordnungsvorgangs mit dem AP oder der Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das UnicastCipher-Element finden Sie unter DOT11_CIPHER_ALGORITHM.
Der Miniporttreiber muss diesen Member auf 0 festlegen, wenn uStatus nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt ist.
MulticastCipher
Der Multicast-Verschlüsselungsalgorithmus, den die 802.11-Station während des Zuordnungsvorgangs mit dem AP oder der Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das MulticastCipher-Element finden Sie unter DOT11_CIPHER_ALGORITHM
Der Miniporttreiber muss diesen Member auf 0 festlegen, wenn uStatus nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt ist.
uActivePhyListOffset
Der Offset der Liste der PHY-Bezeichner (IDs), die die 802.11-Station zum Senden oder Empfangen von Paketen über die BSS-Netzwerkverbindung verwendet.
Das extensible Station (ExtSTA) msDot11ActivePhyList MIB-Objekt verweist auch auf die aktive PHY-Liste.
Weitere Informationen zu diesem MIB-Objekt finden Sie unter OID_DOT11_ACTIVE_PHY_LIST.
Einträge in der aktiven PHY-Liste können einer der folgenden Werte sein:
- Eine PHY-ID, die vom MIB-Objekt extSTA msDot11DesiredPhyList angegeben wird. Weitere Informationen zu diesem MIB-Objekt finden Sie unter OID_DOT11_DESIRED_PHY_LIST.
- DOT11_PHY_ID_ANY. Der Miniporttreiber kann einen Eintrag auf diesen Wert festlegen, wenn das MIB-Objekt msDot11ActivePhyList alle PHY-IDs angibt, die vom MIB-Objekt msDot11DesiredPhyList angegeben werden. Ein Eintrag mit dem Wert DOT11_PHY_ID_ANY muss der einzige Eintrag in der aktiven PHY-Liste sein.
Der Offset der aktiven PHY-Liste ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur enthält.
Der Miniporttreiber muss die Elemente uActivePhyListOffset und uActivePhyListSize auf Null festlegen, wenn uStatus nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt ist.
uActivePhyListSize
Die Länge der aktiven PHY-Liste. Das uActivePhyListSize-Element muss ein Vielfaches von sizeof(ULONG)sein.
bFourAddressSupported
Ein boolescher Wert, der bei Festlegung auf TRUE angibt, dass die 802.11-Station einem AP zugeordnet ist, der DS-Dienste (Verteilungssystem) für iso Layer 2-Überbrückung auf jeder Station im BSS-Netzwerk unterstützt, einschließlich mobiler Stationen und APs. Die Festlegung dieser Unterstützung ist spezifisch für die Umsetzung durch den IHV.
Ein Miniporttreiber muss den bFourAddressSupported-Member auf FALSE festlegen, wenn einer der folgenden Elemente zutrifft:
- Das IEEE 802.11 dot11DesiredBSSType MIB-Objekt ist auf dot11_BSS_type_independent festgelegt.
- Die Station 802.11 hat keinen AP zugeordnet, der DS-Dienste unterstützt, oder kann nicht ermitteln, ob der AP DS-Dienste unterstützt.
- Das uStatus-Element ist nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt.
bPortAuthorized
Ein boolescher Wert, der bei Festlegung auf TRUE angibt, dass die 802.11-Station die Portautorisierung während des Zuordnungsvorgangs erfolgreich ausgeführt hat. Die Portautorisierung kann entweder auf den IEEE 802.1X/802.11i-Standards oder auf einem proprietären Algorithmus basieren, der vom IHV entwickelt wird.
Der Miniporttreiber muss bPortAuthorized auf FALSE festlegen, wenn einer der folgenden Punkte zutrifft:
- Die Station 802.11 führt keine Portautorisierung aus.
- Das uStatus-Element ist nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt.
Weitere Informationen zur Portautorisierung finden Sie unter Portbasierter Netzwerkzugriff.
ucActiveQoSProtocol
Ein Flag, das das QoS-Protokoll (Quality of Service) angibt, das derzeit für diese Zuordnung aktiv ist. Dieser Member ist entweder 0 (was angibt, dass kein QoS-Protokoll aktiv ist) oder eines der folgenden Flags:
DOT11_QOS_PROTOCOL_FLAG_WMM
Die NIC verwendet das QoS-Protokoll 802.11 WMM.
DOT11_QOS_PROTOCOL_FLAG_11E
Die NIC verwendet das QoS-Protokoll 802.11e.
DSInfo
Ein DOT11_DS_INFO Wert, der angibt, ob die 802.11-Station mit demselben DS aus dem vorherigen Zuordnungsvorgang verbunden ist.
Das DSInfo-Element ist als DOT11_DS_INFO-Enumeration formatiert, die die folgenden Werte angibt:
DOT11_DS_CHANGED
Die Station 802.11 wurde nach dem Zuordnungsvorgang mit einem neuen DS verbunden.
DOT11_DS_UNCHANGED
Die Station 802.11 ist über den Zuordnungsvorgang mit derselben DS verbunden.
DOT11_DS_UNKNOWN
Der Miniporttreiber kann nicht ermitteln, ob sich der DS nach dem Zuordnungsvorgang geändert hat.
Hinweis
Der Miniporttreiber muss DSInfo auf DOT11_DS_UNKNOWN festlegen, wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_independent festgelegt ist.
uEncapTableOffset
Der Offset der Liste der IEEE-EtherType-Kapselungen für die BSS-Zuordnung.
Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS-Struktur enthält. Der Wert von uEncapTableOffset muss an einer 4-Byte-Grenze ausgerichtet werden.
Der Miniporttreiber formatiert jeden Eintrag in dieser Liste als DOT11_ENCAP_ENTRY-Struktur .
Weitere Informationen zur EtherType-Kapselungsliste finden Sie unter Nutzlastkapselung 802.11.
uEncapTableSize
Die Länge der EtherType-Kapselungsliste.
MulticastMgmtCipher
Der Multicast-Verschlüsselungsalgorithmus, den die NIC für die Zuordnung für den Verwaltungsframeschutz (MFP) auswähtet (aushandelt). Wenn MFP ausgehandelt wird, sollte dieses Mitglied DOT11_CIPHER_ALGO_BIP werden. Wenn MFP nicht ausgehandelt wird, sollte dieses Feld DOT11_CIPHER_ALGO_NONE werden.
uAssocComebackTime
Wenn eine (Erneute)Zuordnung mit 802.11-Grundcode 30 fehlschlägt ("Zuordnungsanforderung vorübergehend abgelehnt, versuchen Sie es später erneut.") gibt dieses Mitglied den Wert der vom Zugriffspunkt (AP) angeforderten Zuordnungs-Comebackzeit an. Der 802.11-Code für die Trennungsursache ist in den niedrigsten 16 Bits von uStatus vorhanden, wenn auf eine Zuordnungsanforderung reagiert wird.
Der Windows-Dienst für die automatische Verbindung fügt den AP einer Blockierten Liste hinzu und versucht nicht, die Verbindung mindestens für die angegebene Comebackzeit wiederherzustellen. Die NIC verhält sich wie eine reguläre fehlgeschlagene Authentifizierung, bis die nächste Verbindungssequenz gestartet wird. Nachdem das angegebene Timeout (Comeback) abgelaufen ist und der Verbindungsprozess beendet wurde, kann Windows entweder eine bessere alternative Verbindung oder ein Comeback zu dieser Verbindung finden. Dieser in diesem Member festgelegte Wert sollte die in der Spezifikation 802.11 definierten Zeiteinheiten verwenden. Beispiel: TU.
Hinweise
Der Miniporttreiber muss die Elemente uEncapTableOffset und uEncapTableSize auf 0 festlegen, wenn einer der folgenden Elemente zutrifft:
- Die BSS-Zuordnung erfordert keine Änderungen an der Standardliste der EtherType-Kapselungen des Betriebssystems.
- Das uStatus-Element ist nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt.
- Das ExtSTA-Objekt (ExtSTA) dot11DesiredBSSType Management Information Base (MIB) ist auf dot11_BSS_type_independent festgelegt.
Weitere Informationen zum IEEE 802.11 dot11DesiredBSSType MIB-Objekt finden Sie unter OID_DOT11_DESIRED_BSS_TYPE.
Weitere Informationen zum Zuordnungsvorgang finden Sie unter Zuordnungsvorgänge.
Der Verwaltungsrahmenschutz wird ausgehandelt, wenn ein Zugriffspunkt (AP) und STA das MFPC-Feld (Management Frame Protection Capable) während des (Re)Association-Verfahrens (d. h. das 1. Beacon- oder Probeantwort für AP und (Re-)Zuordnungsanforderung für STA), und beide Parteien bestätigen, dass das Management Frame Protection-fähige Bit im 4-Wege-Handshake auf 1 festgelegt ist (Nachrichten M2 und M3 des 4-Wege-Handshake 802.11i).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 8 und höheren Versionen der Windows-Betriebssysteme. |
| Kopfzeile | windot11.h (include Ndis.h) |