DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Rückruffunktion (wlanihv.h)
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) |