wlanapi.h) (WlanUIEditProfile 函数

  • 项目

显示无线配置文件用户界面 (UI) 。 此 UI 用于查看和编辑无线网络配置文件的高级设置。

语法

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
);

参数

[in] dwClientVersion

指定客户端支持的 WLAN API 的最高版本。 除 WLAN_UI_API_VERSION 以外的值将被忽略。

[in] wstrProfileName

包含要查看或编辑的配置文件的名称。 配置文件名称区分大小写。 此字符串必须以 NULL 结尾。

提供的配置文件必须存在于接口 pInterfaceGuid 上。 这意味着配置文件必须以前已创建并保存在配置文件存储中，并且配置文件必须对提供的接口有效。

[in] pInterfaceGuid

接口的 GUID。

[in] hWnd

请求 UI 显示的应用程序窗口的句柄。

[in] wlStartPage

一个 WL_DISPLAY_PAGES值，该值指定显示 UI 对话框时的活动选项卡。

pReserved

保留供将来使用。 必须设置为 NULL。

[out] pWlanReasonCode

指向 WLAN_REASON_CODE 值的指针，该值指示 UI 显示失败的原因。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值可能是以下返回代码之一。

返回代码 说明
ERROR_INVALID_PARAMETER
 提供的其中一个参数无效。
ERROR_NOT_SUPPORTED
 此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数，则将返回此值。
RPC_STATUS
 各种错误代码。

注解

如果 WlanUIEditProfile 返回ERROR_SUCCESS，则对 UI 中对配置文件所做的任何更改都将保存在配置文件存储中。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wlanapi.h (包括 Wlanapi.h)
Library Wlanui.lib
DLL Wlanui.dll