Usando APIs de controles parentais

  • Artigo

Seleção de API

Conforme observado na seção de visão geral, o desenvolvimento envolve o uso de até três APIs:

  • Acesso de configurações básicas: a API COM de conformidade mínima dos Controles Parentais (API de Conformidade) definida em Wpcapi.h para acesso simples a um subconjunto chave do estado controles parentais.
  • Acesso de gravação/leitura de configurações completas: o uso de um pequeno subconjunto da API COM do WMI para acesso completo só será necessário se o ISV precisar modificar as configurações. A adição de um link de extensibilidade da interface do usuário, substituição do Filtro de Conteúdo da Web ou adições ao aplicativo HTTP em todo o computador ou listas de isenção de filtragem de URL são os principais motivos para usar a API. Como o uso do namespace controles parentais WMI fornece acesso bruto ao repositório de configurações subjacente, os ISVs devem continuar com cuidado na interpretação do estado de configurações individuais que podem de fato ter dependências de gating em outras configurações. Portanto, é recomendável usar a API de Conformidade para o estado de leitura para todos os valores expostos por essa API.
  • Registro em log: a API do sistema de Rastreamento de Eventos e Relatórios do Windows Vista (também conhecida como ETW) para publicar eventos de atividade nos logs de Controles Parentais, em conjunto com descritores de eventos e enumerações de matriz definidas em WpcEvent.h.

Todas as APIs podem ser chamadas como um usuário padrão. Para registro em log, qualquer usuário pode gerar eventos de log. Chamar para recuperar ou alterar as configurações de outro usuário falhará se o chamador não tiver privilégios de administrador. Em outras palavras, um usuário padrão pode acessar apenas suas próprias configurações e somente para leitura.

As configurações e o uso da API de registro em log são discutidos mais adiante nestas seções:

Ambiente de desenvolvimento

O desenvolvimento para controles parentais requer acesso a três arquivos de cabeçalho: Wpc.h, WpcApi.h e WpcEvent.h. O Wpc.h é um coletor que inclui as configurações de API de conformidade pública e cabeçalhos de eventos, portanto, é suficiente incluir wpc.h no código do aplicativo.

As permissões de leitura/gravação para a API WMI são especificadas pelo arquivo Wpcsprov.mof. Esse arquivo é instalado no subdiretório WBEM no diretório Windows System32.

O Microsoft Windows Software Development Kit (SDK) contém código de exemplo para reforçar o código de exemplo mostrado aqui e fornecer ferramentas simples controladas por linha de comando para exploração de API ou teste de integração.