Функция WlanUIEditProfile (wlanapi.h)

  • Статья

Отображает пользовательский интерфейс беспроводного профиля. Этот пользовательский интерфейс используется для просмотра и изменения дополнительных параметров профиля беспроводной сети.

Синтаксис

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

Указывает самую высокую версию API WLAN, которую поддерживает клиент. Значения, отличные от WLAN_UI_API_VERSION, будут игнорироваться.

[in] wstrProfileName

Содержит имя профиля для просмотра или изменения. В именах профилей учитывается регистр. Эта строка должна быть завершена null.

Предоставленный профиль должен присутствовать в интерфейсе pInterfaceGuid. Это означает, что профиль должен быть ранее создан и сохранен в хранилище профилей, а профиль должен быть действительным для предоставленного интерфейса.

[in] pInterfaceGuid

GUID интерфейса.

[in] hWnd

Дескриптор окна приложения, запрашивающего отображение пользовательского интерфейса.

[in] wlStartPage

Значение WL_DISPLAY_PAGES , указывающее активную вкладку при появлении диалогового окна пользовательского интерфейса.

pReserved

Зарезервировано для последующего использования. Необходимо задать значение NULL.

[out] pWlanReasonCode

Указатель на значение WLAN_REASON_CODE , указывающее причину сбоя отображения пользовательского интерфейса.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.

Код возврата Описание
ERROR_INVALID_PARAMETER
 Один из предоставленных параметров недопустим.
ERROR_NOT_SUPPORTED
 Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).
RPC_STATUS
 Различные коды ошибок.

Комментарии

Если WlanUIEditProfile возвращает ERROR_SUCCESS, все изменения профиля, внесенные в пользовательском интерфейсе, будут сохранены в хранилище профилей.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header wlanapi.h (включая Wlanapi.h)
Библиотека Wlanui.lib
DLL Wlanui.dll