Compartilhar via

Exibindo páginas de interface do usuário personalizadas em uma notificação de balão

  • Artigo

 

Se a DLL de Extensões IHV nativas 802.11 chamar Dot11ExtSendUIRequest para exibir uma interface do usuário personalizada, o sistema operacional exibirá a interface do usuário por meio de uma notificação de balão clicável se o adaptador WLAN (LAN) sem fio tiver se conectado a uma rede sem fio. Nessa situação, a solicitação para a interface do usuário personalizada é exibida como uma notificação de balão:

Para obter mais informações sobre como a DLL de Extensões IHV do Native 802.11 solicita a exibição de uma interface do usuário personalizada, consulte Solicitando a exibição de uma interface do usuário personalizada.

Ao processar uma solicitação de interface do usuário personalizada como uma notificação de balão, o sistema operacional faz o seguinte.

  1. Chama a função Dot11ExtIhvIsUIRequestPending do Manipulador IHV das Extensões IHV nativas 802.11 para determinar se uma solicitação de interface do usuário ainda está pendente. O sistema operacional especifica a solicitação de interface do usuário usando o GUID (identificador global exclusivo) passado para Dot11ExtSendUIRequest pela DLL de Extensões IHV nativas 802.11.

  2. Se Dot11ExtIhvIsUIRequestPending retornar TRUE para a solicitação de interface do usuário especificada, o sistema operacional chamará o método IDot11Ext11ExtUIBalloonText das Extensões de IHV nativas da DLL. Por meio desse método, a DLL retorna um buffer de cadeia de caracteres que contém o texto localizado a ser exibido na notificação de balão.

  3. Exibe a notificação de balão que contém o texto localizado.

  4. Se o usuário final clicar na notificação de balão, o sistema operacional iniciará a interface do usuário personalizada compatível com a interface COM IWizardExtension solicitada. Quando chama Dot11ExtSendUIRequest, a DLL de Extensões IHV nativas 802.11 especifica o CLSID (identificador de classe) da implementação IWizardExtension na DLL de Extensões de IHV nativas 802.11.

    Quando o sistema operacional chama o método IWizardExtension::AddPages , a DLL de Extensões de IHV de IHV Nativas 802.11 retorna uma matriz de identificadores para estruturas PROPSHEETPAGE que representam as páginas de interface do usuário personalizadas.

    Para obter mais informações sobre a interface COM IWizardExtension , consulte Interface COM IWizardExtension. Para obter mais informações sobre a estrutura PROPSHEETPAGE, consulte a documentação no SDK do Microsoft Windows.

  5. Navega pelas páginas da interface do usuário conforme especificado pela DLL de Extensões de Interface do Usuário do Native 802.11 IHV por meio da interface COM IWizardSite . Para obter mais informações sobre essa interface, consulte Interface COM IWizardSite.

Enquanto a interface do usuário personalizada é exibida, a DLL de Extensões de Interface do Usuário do Native 802.11 IHV pode ler ou gravar dados específicos do contexto por meio da interface COM IPropertyBag. Para obter mais informações sobre esse processo, consulte Acessando dados de perfil e contexto. Depois que a exibição da interface do usuário personalizada for concluída, a DLL de Extensões de IHV de IHV nativas 802.11 poderá retornar os dados de resposta inseridos pelo usuário para a DLL de Extensões IHV nativas 802.11 chamando WlanSendUIResponse . A DLL passa o GUID para a solicitação de interface do usuário, bem como um ponteiro para um buffer que contém os dados de resposta.

Após a DLLcalls WlanSendUIResponse do Native 802.11 IHV Extensions WlanSendUIResponse, o sistema operacional chamará a função Dot11ExtIhvProcessUIResponse IHV Handler da Extensão Nativa 802.11 para encaminhar os dados de resposta para a interface do usuário personalizada.

Para obter mais informações sobre a API WlanSendUIResponse , consulte a documentação no SDK do Windows.