DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Rückruffunktion (wlanihv.h)

Artikel
03/01/2024

Wichtig Die native WLAN-Schnittstelle 802.11 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 driver model.

Die DLL für IHV-Erweiterungen ruft die Dot11ExtGetProfileCustomUserData-Funktion auf, um Daten aus der Systemregistrierung abzurufen, die speziell für den aktuellen Benutzer und das Netzwerkprofil für die BSS-Netzwerkverbindung (Basic Service Set) verwendet werden.

Syntax

DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Dot11extGetProfileCustomUserData;

DWORD Dot11extGetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [out]          DWORD *pdwDataSize,
  [out]          LPVOID *ppvData
)
{...}

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] dwSessionID

Die Sitzungs-ID (Sitzungs-ID) des aktuellen Benutzers.

[out] pdwDataSize

Ein Zeiger auf eine vom Aufrufer bereitgestellte Variable, die die Größe des Puffers in Bytes speichert, auf den ppvData verweist.

[out] ppvData

Die Adresse einer Zeigervariable, die die Adresse des Puffers speichert, der die Benutzerdaten enthält.

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

Das Betriebssystem entschlüsselt die Daten, auf die vom ppvData-Parameter nach dem Lesen aus der Systemregistrierung verwiesen wird, nicht. Die DLL für IHV-Erweiterungen sollte einen eigenen Entschlüsselungsalgorithmus verwenden, um die Daten nach dem Aufruf von Dot11ExtGetProfileCustomUserData zu entschlüsseln.

Für jedes wlan-Profil, das vom Native Wifi AutoConfig-Dienst verwendet wird, behält Windows das Konzept der benutzerdefinierten Benutzerdaten bei. Diese benutzerdefinierten Benutzerdaten sind anfänglich nicht vorhanden, können jedoch durch Aufrufen der Dot11ExtSetProfileCustomUserData-Funktion . Die benutzerdefinierten Benutzerdaten werden jedes Mal auf leer zurückgesetzt, wenn das Profil durch Aufrufen von Dot11ExtSetCurrentProfile-Funktion .

Nachdem benutzerdefinierte Benutzerdaten festgelegt wurden, kann mithilfe der Dot11ExtGetProfileCustomUserData-Funktion auf diese Daten zugegriffen werden.

Der Aufrufer ist dafür verantwortlich, den Speicher freizugeben, der dem Puffer zugeordnet ist, auf den der ppvData-Parameter verweist, mithilfe der Dot11ExtFreeBuffer-Funktion .

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)

Weitere Informationen

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetProfileCustomUserData Dot11ExtIhvPerformPreAssociate

Dot11ExtSetCurrentProfile

Freigeben über