Função WlanUIEditProfile (wlanapi.h)

Exibe a interface do usuário (interface do usuário) do perfil sem fio. Essa interface do usuário é usada para exibir e editar configurações avançadas de um perfil de rede sem fio.

Sintaxe

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 a versão mais alta da API WLAN à qual o cliente dá suporte. Valores diferentes de WLAN_UI_API_VERSION serão ignorados.

[in] wstrProfileName

Contém o nome do perfil a ser exibido ou editado. Os nomes de perfil diferenciam maiúsculas de minúsculas. Essa cadeia de caracteres deve ser terminada em NULL.

O perfil fornecido deve estar presente na interface pInterfaceGuid. Isso significa que o perfil deve ter sido criado e salvo anteriormente no repositório de perfil e que o perfil deve ser válido para a interface fornecida.

[in] pInterfaceGuid

O GUID da interface.

[in] hWnd

O identificador da janela do aplicativo que solicita a exibição da interface do usuário.

[in] wlStartPage

Um valor WL_DISPLAY_PAGES que especifica a guia ativa quando a caixa de diálogo da interface do usuário é exibida.

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

[out] pWlanReasonCode

Um ponteiro para um valor de WLAN_REASON_CODE que indica por que a exibição da interface do usuário falhou.

Retornar valor

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de retorno.

Código de retorno	Descrição
ERROR_INVALID_PARAMETER	Um dos parâmetros fornecidos não é válido.
ERROR_NOT_SUPPORTED	Essa função foi chamada de uma plataforma sem suporte. Esse valor será retornado se essa função for chamada de um Windows XP com SP3 ou API lan sem fio para Windows XP com cliente SP2.
RPC_STATUS	Vários códigos de erro.

Comentários

Se WlanUIEditProfile retornar ERROR_SUCCESS, todas as alterações no perfil feitas na interface do usuário serão salvas no repositório de perfis.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wlanapi.h (inclua Wlanapi.h)
Biblioteca	Wlanui.lib
DLL	Wlanui.dll