IDot11ExtUIProperty::Dot11ExtUIPropertyGetDisplayInfo method

Article
12/01/2017

Important The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

The IDot11ExtUIProperty::Dot11ExtUIPropertyGetDisplayInfo method allows the Native 802.11 IHV UI Extensions DLL to specify additional display elements that are used to extend the Security tab of the Network Configuration UI.

Syntax

HRESULT Dot11ExtUIPropertyGetDisplayInfo(
  [in]  DOT11_EXT_UI_DISPLAY_INFO_TYPE     dot11ExtUIDisplayInfoType,
  [in]  BSTR                               bstrIHVProfile,
  [in]  PDOT11EXT_IHV_PARAMS               pIHVProfileParams,
  [out] ULONG                              *pcEntries,
  [out] ULONG                              *puDefaultSelection,
  [out] DOT11_EXT_UI_PROPERTY_DISPLAY_INFO **ppDot11ExtUIProperty
);

Parameters

dot11ExtUIDisplayInfoType [in]
The type of display element to be returned, as specified by a DOT11_EXT_UI_DISPLAY_INFO_TYPE value.
bstrIHVProfile [in]
The XML fragment that contains the IHV-defined data from the current security profile data. This fragment is bounded by the <IHV> and </IHV> XML tags. For more information about the format of the Native 802.11 profile data, refer to the documentation within the Microsoft Windows SDK.
pIHVProfileParams [in]
The parameters of the current security profile, formatted as a DOT11EXT_IHV_PROFILE_PARAMS structure.
pcEntries [out]
The number of entries in the array of DOT11_EXT_UI_PROPERTY_DISPLAY_INFO structures returned in the ppDot11ExtUIProperty parameter.
puDefaultSelection [out]
The index of the entry within the array of DOT11_EXT_UI_PROPERTY_DISPLAY_INFO structures that will be displayed as the default selection.
ppDot11ExtUIProperty [out]
A pointer to a list of DOT11_EXT_UI_PROPERTY_DISPLAY_INFO entries.

Return value

If the call succeeds, the method returns S_OK.

If the call fails, the method returns the appropriate error code defined in Winerror.h.

Remarks

If the Native 802.11 IHV UI Extensions DLL supports an IDot11ExtUIProperty COM Interface for a property type of DOT11_EXT_UI_KEYEXTENSION, the operating system will call the interface's IDot11ExtUIProperty::Dot11ExtUIPropertyGetDisplayInfo method before displaying the properties of the Security tab in the Network Configuration UI. The operating system queries the property extensions that are supported by the Native 802.11 IHV UI Extensions DLL by calling the IDot11ExtUI::GetDot11ExtUIProperties method.

For more information about extending the properties of the Network Configuration UI, see Extending the Property Pages for Wireless Network Profiles.

For more information about the Network Configuration UI and other Native 802.11 components, see Native 802.11 Software Architecture.

Requirements

Target platform	Desktop
Minimum support	Available in Windows Vista and later versions of the Windows operating systems.
IDL	Wlanihvui.idl

Share via