Partager via

Utilisation des API de contrôle parental

  • Article

Sélection de l’API

Comme indiqué dans la section vue d’ensemble, le développement implique l’utilisation d’un maximum de trois API :

  • Accès aux paramètres de base : l’API COM de conformité minimale du contrôle parental définie dans Wpcapi.h pour un accès simple à un sous-ensemble clé de l’état du contrôle parental.
  • Accès complet en écriture/lecture des paramètres : l’utilisation d’un petit sous-ensemble de l’API COM WMI pour un accès total n’est requise que si l’éditeur de logiciels indépendants doit modifier les paramètres. L’ajout d’un lien d’extensibilité de l’interface utilisateur, le remplacement du filtre de contenu web ou les ajouts à l’application HTTP à l’échelle de l’ordinateur ou aux listes d’exemption de filtrage d’URL sont les principales raisons d’utiliser l’API. Étant donné que l’utilisation de l’espace de noms WMI Parental Controls fournit un accès brut au magasin de paramètres sous-jacent, les éditeurs de logiciels indépendants doivent procéder avec prudence à l’interprétation de l’état à partir de paramètres individuels qui peuvent en fait avoir des dépendances par rapport à d’autres paramètres. Il est donc recommandé d’utiliser l’API Conformité pour la lecture de l’état pour toutes les valeurs exposées par cette API.
  • Journalisation : l’API système de suivi et de création de rapports d’événements Windows Vista (également appelée ETW) pour la publication des événements d’activité dans les journaux du contrôle parental, conjointement avec les descripteurs d’événements et les énumérations de tableau définies dans WpcEvent.h.

Toutes les API peuvent être appelées en tant qu’utilisateur standard. Pour la journalisation, tout utilisateur peut sourcer des événements de journal. L’appel pour récupérer ou modifier les paramètres d’un autre utilisateur échoue si l’appelant ne dispose pas de privilèges d’administrateur. En d’autres termes, un utilisateur standard peut accéder à ses propres paramètres uniquement, et uniquement pour la lecture.

Les paramètres et l’utilisation de l’API de journalisation sont décrits plus en détail dans ces sections :

Environnement de développement

Le développement pour le contrôle parental nécessite l’accès à trois fichiers d’en-tête : Wpc.h, WpcApi.h et WpcEvent.h. Wpc.h est un collecteur qui inclut les paramètres de l’API de conformité publique et les en-têtes d’événement. Il suffit donc d’inclure Wpc.h dans le code de l’application.

Les autorisations en lecture/écriture sur l’API WMI sont spécifiées par le fichier Wpcsprov.mof. Ce fichier est installé dans le sous-répertoire WBEM sous le répertoire Windows System32.

Le Kit de développement logiciel (SDK) Microsoft Windows contient un exemple de code pour renforcer l’exemple de code présenté ici et fournir des outils simples pilotés par la ligne de commande pour l’exploration des API ou les tests d’intégration.