Compartilhar via

Estendendo propriedades de conexão sem fio

  • Artigo

 

Este tópico descreve como uma DLL de Extensões de IHV IHV Nativas 802.11 estende as propriedades na guia Conexão exibidas por meio da interface do usuário da Configuração de Rede. Nessa situação, a DLL de Extensões de Interface do Usuário IHV nativa 802.11 adiciona propriedades à guia Conexão para configurações de conexão proprietárias.

Para obter mais informações sobre a interface do usuário de configuração de rede e outros componentes nativos do 802.11, consulte Arquitetura de software nativa 802.11.

Antes de exibir a guia Conexão , o sistema operacional faz o seguinte:

  1. Consulta a DLL de Extensões de IHV do Native 802.11 para suas propriedades de conexão por meio de uma chamada para o método IDot11ExtUI::GetDot11ExtUIProperties . O sistema operacional passa um valor de DOT11_EXT_UI_CONNECTION para o parâmetro ExtType do método.

    Se a DLL de extensão de interface do usuário IHV nativa 802.11 der suporte a uma propriedade do tipo DOT11_EXT_UI_CONNECTION, a DLL retornará (por meio do parâmetro ppDot11ExtUIProperty do método) o endereço da interface COM IDot11ExtUIProperty, que implementa a extensão da propriedade de conexão. Para obter mais informações sobre as interfaces COM usadas para estender as propriedades de conexão, consulte Interfaces COM de extensões de interface do usuário IHV nativas 802.11.

    Nota Para o Windows Vista, a DLL de Extensões de Interface do Usuário IHV nativa 802.11 não deve retornar mais de uma Interface COM IDot11ExtUI para uma extensão de propriedade de conexão.

     

  2. Se a DLL de extensões de interface do usuário IHV nativa 802.11 der suporte a uma propriedade de conexão, o sistema operacional consultará o nome amigável da extensão de propriedade chamando o método IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName da extensão. O sistema operacional insere o nome amigável dentro do texto "Habilitar configurações de conexão xxx ", em que "xxx" é o nome amigável da extensão de propriedade. O sistema operacional exibe esse texto junto com uma caixa marcar na guia Conexão.

  3. Consulta a extensão para determinar se ela tem uma propriedade de interface do usuário personalizada que pode ser exibida. O sistema operacional faz isso chamando o método IDot11ExtUIProperty::D ot11ExtUIPropertyHasConfigurationUI da extensão. Se a extensão da propriedade de conexão der suporte a uma propriedade de interface do usuário personalizada, o sistema operacional adicionará um botão Configurar abaixo da caixa marcar da propriedade.

Se a configuração de conexão proprietária selecionada der suporte a uma interface do usuário de configuração e o usuário final clicar no botão Configurar na guiaConexão , o sistema operacional chamará o método IDot11ExtUIProperty::D isplayDot11ExtUIProperty da propriedade de conexão para iniciar a interface do usuário personalizada. O sistema operacional passa os dados de perfil atuais para a extensão por meio do argumento bstrIHVProfile do método.

Os dados do perfil são formatados como um fragmento XML limitado pelas <marcas XML IHV></IHV> . Os dados XML dentro dessas marcas são específicos para a implementação do IHV e são opacos para o sistema operacional. Para obter mais informações sobre o formato dos dados de perfil do Native 802.11, consulte a documentação no SDK do Microsoft Windows.

Se os dados do perfil forem alterados por meio da interface do usuário personalizada, o método IDot11ExtUIProperty::D isplayDot11ExtUIProperty da extensão deverá fazer o seguinte antes de retornar:

  • Aloque um buffer de cadeia de caracteres para os dados de perfil modificados e retorne um ponteiro para o buffer por meio do parâmetro bstrModifiedIHVProfile do método. Nota O método IDot11ExtUIProperty::D isplayDot11ExtUIProperty da extensão não deve modificar os dados referenciados pelo argumento bstrIHVProfile .

     

  • Defina o argumento pbIsModified comoTRUE.