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 |
---|---|
|
Um dos parâmetros fornecidos não é válido. |
|
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. |
|
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 |