Estendendo propriedades de segurança sem fio
Este tópico descreve como uma DLL de Extensões de IHV IHV Nativas 802.11 estende as propriedades da guia Segurança que é exibida por meio da interface do usuário da Configuração de Rede . Nessa situação, a DLL de Extensões de IHV IHV nativas 802.11 adiciona propriedades à guia Segurança para configurações de segurança proprietárias que são mutuamente exclusivas do módulo Native 802.11 802.1X.
A DLL de Extensões de IHV IHV Nativas 802.11 também pode estender os métodos de segurança e criptografia compatíveis com o módulo Native 802.11 802.1X. Para obter mais informações sobre como a DLL faz isso, consulte Estendendo as configurações de segurança do Microsoft 802.1X.
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 Segurança , o sistema operacional faz o seguinte:
Consulta a DLL de Extensões de IHV do Native 802.11 para suas extensões de propriedade de segurança por meio de uma chamada para o método IDot11ExtUI::GetDot11ExtUIProperties . O sistema operacional passa um valor de DOT11_EXT_UI_SECURITY 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 ou mais propriedades do tipo DOT11_EXT_UI_SECURITY, a DLL retornará (por meio do parâmetro ppDot11ExtUIProperty do método) uma lista de interfaces COM IDot11ExtUIProperty para as extensões de propriedade de segurança compatíveis com a DLL. Para obter mais informações sobre as interfaces COM usadas para estender as propriedades de segurança, consulte Interfaces COM de extensões de interface do usuário IHV nativas 802.11.
Consulta o nome amigável da extensão de segurança chamando o método IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName da extensão. O sistema operacional adiciona o nome amigável à lista de configurações de segurança proprietárias na parte inferior da guia Segurança .
Se o usuário final selecionar um item dessa lista, o sistema operacional chamará o método IDot11ExtUIProperty::D ot11ExtUIPropertyGetSelected das interfaces COM IDot11ExtUIProperty de cada extensão de segurança. A primeira extensão que retorna com um valor true para o parâmetro pfIsSelected do método é determinada como sendo a extensão selecionada. A entrada selecionada na lista será realçada.
Consulta o método IDot11ExtUIProperty::D ot11ExtUIPropertyHasConfigurationUI da configuração selecionada para determinar se ele tem uma página de propriedades de interface do usuário personalizada que pode ser exibida. Se o método retornar com o parâmetro fHasConfigurationUI definido como TRUE, o sistema operacional adicionará um botão Configurar ao lado da lista de configurações de segurança proprietárias.
Se a configuração de segurança proprietária selecionada der suporte a uma interface do usuário de configuração e o usuário final clicar no botão Configurar , o sistema operacional chamará o método IDot11ExtUIProperty::D isplayDot11ExtUIProperty da configuração para iniciar a interface do usuário personalizada. O sistema operacional passa os dados de perfil atuais para a configuraçã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 configuraçã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 configuração não deve modificar os dados referenciados pelo argumento bstrIHVProfile .
Defina o argumento pbIsModified comoTRUE.