WlanUIEditProfile 函式 (wlanapi.h)

  • 發行項

(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。

如果函式失敗，傳回值可能是下列其中一個傳回碼。

傳回碼 Description
ERROR_INVALID_PARAMETER
 其中一個提供的參數無效。
ERROR_NOT_SUPPORTED
 從不支援的平臺呼叫此函式。 如果使用SP2用戶端從具有SP3的Windows XP或適用於Windows XP的無線LAN API 呼叫此函式，將會傳回此值。
RPC_STATUS
 各種錯誤碼。

備註

如果 WlanUIEditProfile 傳回ERROR_SUCCESS，UI 中所做的任何配置檔變更都會儲存在配置檔存放區中。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wlanapi.h (包含 Wlanapi.h)
程式庫 Wlanui.lib
Dll Wlanui.dll