Compartir a través de

Función WlanUIEditProfile (wlanapi.h)

  • Artículo

Muestra la interfaz de usuario (UI) del perfil inalámbrico. Esta interfaz de usuario se usa para ver y editar la configuración avanzada de un perfil de red inalámbrica.

Sintaxis

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

Parámetros

[in] dwClientVersion

Especifica la versión más alta de la API WLAN que admite el cliente. Se omitirán los valores distintos de WLAN_UI_API_VERSION.

[in] wstrProfileName

Contiene el nombre del perfil que se va a ver o editar. Los nombres de perfil distinguen mayúsculas de minúsculas. Esta cadena debe terminar en NULL.

El perfil proporcionado debe estar presente en la interfaz pInterfaceGuid. Esto significa que el perfil debe haberse creado y guardado previamente en el almacén de perfiles y que el perfil debe ser válido para la interfaz proporcionada.

[in] pInterfaceGuid

GUID de la interfaz.

[in] hWnd

Identificador de la ventana de la aplicación que solicita la presentación de la interfaz de usuario.

[in] wlStartPage

Valor de WL_DISPLAY_PAGES que especifica la pestaña activa cuando aparece el cuadro de diálogo de la interfaz de usuario.

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

[out] pWlanReasonCode

Puntero a un valor de WLAN_REASON_CODE que indica por qué se produjo un error en la presentación de la interfaz de usuario.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno de los parámetros proporcionados no es válido.
ERROR_NOT_SUPPORTED
 Se llamó a esta función desde una plataforma no admitida. Este valor se devolverá si se llamó a esta función desde un Windows XP con SP3 o LAN inalámbrica API para Windows XP con el cliente SP2.
RPC_STATUS
 Varios códigos de error.

Comentarios

Si WlanUIEditProfile devuelve ERROR_SUCCESS, los cambios realizados en el perfil realizado en la interfaz de usuario se guardarán en el almacén de perfiles.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wlanapi.h (incluya Wlanapi.h)
Library Wlanui.lib
Archivo DLL Wlanui.dll