DOT11EXT_SET_CURRENT_PROFILE Rückruffunktion (wlanihv.h)
Syntax
DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;
DWORD Dot11extSetCurrentProfile(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] HANDLE hConnectSession,
[in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
[in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}
Parameter
[in, optional] hDot11SvcHandle
Das Handle, das vom Betriebssystem verwendet wird, um auf den WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.
[in, optional] hConnectSession
Das Handle, das vom Betriebssystem verwendet wird, um auf die Verbindungssitzung mit dem BSS-Netzwerk (Basic Service Set) zu verweisen. Dieser Handle-Wert wurde durch einen vorherigen Aufruf von angegeben. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.
[in, optional] pIhvConnProfile
Ein Zeiger auf eine DOT11EXT_IHV_CONNECTIVITY_PROFILE Struktur, die Konnektivitätseinstellungen für das IHV-Profil enthält.
[in, optional] pIhvSecProfile
Ein Zeiger auf eine DOT11EXT_IHV_SECURITY_PROFILE Struktur, die Sicherheitseinstellungen für das IHV-Profil angibt.
Rückgabewert
Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein in Winerror.h definierter Fehlercode zurückgegeben.
Hinweise
Die Dot11ExtSetCurrentProfile-Funktion ermöglicht es dem IHV, dem aktuellen Netzwerkprofil, das für die BSS-Netzwerkverbindung (Basic Service Set) verwendet wird, benutzerdefinierte Konnektivitäts- und Sicherheitsprofilfragmente hinzuzufügen. Die Profilfragmente sind IHV-spezifisch und gelten für Konnektivitäts- oder Sicherheitserweiterungen, die dem Benutzer über die NATIVE 802.11-DLL für IHV-UI-Erweiterungen zur Verfügung stehen.
Die DLL für IHV-Erweiterungen muss beim Aufrufen der Dot11ExtSetCurrentProfile-Funktion die folgenden Richtlinien befolgen:
- Die DLL für IHV-Erweiterungen darf nur Dot11ExtSetCurrentProfile aufrufen, wenn sie einen Vorabzuordnungsvorgang ausführt, der über einen Aufruf von initiiert wird. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion. Weitere Informationen zum Vorgang vor der Zuordnung finden Sie unter Pre-Association Operation.
- Die DLL für IHV-Erweiterungen darf Dot11ExtSetCurrentProfile nicht innerhalb des Aufrufs von aufrufen. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion. Dot11ExtSetCurrentProfile muss von einem anderen Thread als dem aufgerufen werden, der den Aufruf von Dot11ExtIhvPerformPreAssociate verarbeitet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | wlanihv.h (wlanihv.h einschließen) |