DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES fonction de rappel (wlanihv.h)
La DLL des extensions IHV appelle la fonction Dot11ExtSetVirtualStationAPProperties pour spécifier la connexion de profil IHV actuelle.
Syntaxe
DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Dot11extSetVirtualStationApProperties;
DWORD Dot11extSetVirtualStationApProperties(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] HANDLE hConnectSession,
[in] DWORD dwNumProperties,
[in] PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
LPVOID pvReserved
)
{...}
Paramètres
[in, optional] hDot11SvcHandle
Handle facultatif utilisé par le système d’exploitation pour référencer l’adaptateur LAN sans fil (WLAN) physique principal. Cette valeur de handle a été reçue en tant que paramètre hDot11SvcHandle lors d’un appel précédent à la fonction Gestionnaire IHV Dot11ExtIhvInitAdapter .
[in, optional] hConnectSession
Handle utilisé par le système d’exploitation pour référencer la session de connexion actuelle avec le réseau BSS (Basic Service Set). Cette valeur de handle a été reçue en tant que paramètre hConnectSession par le biais d’un appel précédent à Dot11ExtIhvPerformPreAssociate Fonction de gestionnaire IHV.
[in] dwNumProperties
Nombre d’éléments dans le tableau de structures pointées vers le paramètre pProperties .
[in] pProperties
Pointeur vers un tableau de DOT11EXT_VIRTUAL_STATION_AP_PROPERTY structures qui spécifient les propriétés des points d’accès que la station virtuelle 802.11 tente d’héberger dans la session de connexion actuelle.
pvReserved
Ce paramètre est réservé au système d’exploitation et doit avoir la valeur NULL.
Valeur retournée
Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, il retourne un code d’erreur défini dans Winerror.h.
Remarques
Si la connexion de profil IHV actuelle est un point d’accès et que la DLL des extensions IHV peut fournir au système d’exploitation les paramètres utilisés par l’AP, le système d’exploitation peut fournir des informations supplémentaires aux utilisateurs qui demandent un service lié à l’AP auprès du système d’exploitation.
Si la DLL des extensions IHV appelle Dot11ExtSetVirtualStationAPProperties, elle doit le faire avant d’appeler le Dot11ExtIhvPerformPreAssociate Fonction de gestionnaire IHV. Si Dot11ExtSetVirtualStationAPProperties n’est pas appelé avant la réussite de l’opération de pré-association, le système d’exploitation ne fait aucune hypothèse sur la nature du profil IHV.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 7 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wlanihv.h (inclure Wlanihv.h) |