Hardware Dev Center

Dot11ExtSetVirtualStationAPProperties function

The IHV Extensions DLL calls the Dot11ExtSetVirtualStationAPProperties function to specify the current IHV profile connection.

Syntax


DWORD APIENTRY Dot11ExtSetVirtualStationAPProperties(
  _In_opt_   HANDLE                                hDot11SvcHandle,
  _In_opt_   HANDLE                                hConnectSession,
  _In_       DWORD                                 dwNumProperties,
  _In_       PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
  _Reserved_ LPVOID                                pvReserved
);

Parameters

hDot11SvcHandle [in, optional]

An optional handle used by the operating system to reference the primary physical wireless LAN (WLAN) adapter. This handle value was received as the hDot11SvcHandle parameter through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.

hConnectSession [in, optional]

The handle used by the operating system to reference the current connection session with the basic service set (BSS) network. This handle value was received as the hConnectSession parameter through a previous call to the Dot11ExtIhvPerformPreAssociate IHV Handler function.

dwNumProperties [in]

The number of elements in the array of structures pointed to by the pProperties parameter.

pProperties [in]

A pointer to an array of DOT11EXT_VIRTUAL_STATION_AP_PROPERTY structures that specify the properties of access points (APs) that the virtual 802.11 station is attempting to host in the current connection session.

pvReserved

This parameter is reserved for use by the operating system and should be NULL.

Return value

If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.

Remarks

If the current IHV profile connection is an access point (AP), and the IHV Extensions DLL can provide to the operating system the settings used by the AP, the operating system can provide additional information to users who request AP-related service from the operating system.

If the IHV Extensions DLL calls Dot11ExtSetVirtualStationAPProperties, it must do so before it calls the Dot11ExtIhvPerformPreAssociate IHV Handler function. If Dot11ExtSetVirtualStationAPProperties is not called before successful completion of the pre-association operation, the operating system makes no assumptions about the nature of the IHV profile.

Requirements

Target platform

Desktop

Version

Available in Windows 7 and later versions of the Windows operating systems.

Header

Wlanihv.h (include Wlanihv.h)

See also

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY
Dot11ExtIhvInitAdapter
Dot11ExtIhvPerformPreAssociate

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft