WlanUIEditProfile function (wlanapi.h)

Displays the wireless profile user interface (UI). This UI is used to view and edit advanced settings of a wireless network profile.

Syntax

DWORD WlanUIEditProfile(
  [in]  DWORD             dwClientVersion,
  [in]  LPCWSTR           wstrProfileName,
  [in]  GUID              *pInterfaceGuid,
  [in]  HWND              hWnd,
  [in]  WL_DISPLAY_PAGES  wlStartPage,
        PVOID             pReserved,
  [out] PWLAN_REASON_CODE pWlanReasonCode
);

Parameters

[in] dwClientVersion

Specifies the highest version of the WLAN API that the client supports. Values other than WLAN_UI_API_VERSION will be ignored.

[in] wstrProfileName

Contains the name of the profile to be viewed or edited. Profile names are case-sensitive. This string must be NULL-terminated.

The supplied profile must be present on the interface pInterfaceGuid. That means the profile must have been previously created and saved in the profile store and that the profile must be valid for the supplied interface.

[in] pInterfaceGuid

The GUID of the interface.

[in] hWnd

The handle of the application window requesting the UI display.

[in] wlStartPage

A WL_DISPLAY_PAGES value that specifies the active tab when the UI dialog box appears.

pReserved

Reserved for future use. Must be set to NULL.

[out] pWlanReasonCode

A pointer to a WLAN_REASON_CODE value that indicates why the UI display failed.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value may be one of the following return codes.

Remarks

If WlanUIEditProfile returns ERROR_SUCCESS, any changes to the profile made in the UI will be saved in the profile store.

Requirements