Freigeben über

Verwenden von Jugendschutz-APIs

  • Artikel

API-Auswahl

Wie im Abschnitt "Übersicht" erwähnt, umfasst die Entwicklung die Verwendung von bis zu drei APIs:

  • Zugriff auf Grundlegende Einstellungen: Die in Wpcapi.h definierte COM-API (Compliance-API) für die Mindestkonformität der Kindersicherung für den einfachen Zugriff auf eine wichtige Teilmenge des Jugendschutzzustands.
  • Schreib-/Lesezugriff für vollständige Einstellungen: Die Verwendung einer kleinen Teilmenge der WMI-COM-API für vollzugriff ist nur erforderlich, wenn der ISV Einstellungen ändern muss. Das Hinzufügen eines Erweiterungslinks für die Benutzeroberfläche, das Ersetzen des Webinhaltsfilters oder die Ergänzungen der computerweiten HTTP-Anwendungs- oder URL-Filterausnahmelisten sind die hauptverantwortlichen Gründe für die Verwendung der API. Da die Verwendung des WMI-Jugendschutznamespaces rohen Zugriff auf den zugrunde liegenden Einstellungsspeicher bietet, sollten ISVs mit Vorsicht den Zustand einzelner Einstellungen interpretieren, die tatsächlich Gatingabhängigkeiten von anderen Einstellungen aufweisen können. Es wird daher empfohlen, die Compliance-API zum Lesen des Zustands für alle Werte zu verwenden, die von dieser API verfügbar gemacht werden.
  • Protokollierung: Die Ereignisablaufverfolgungs- und Berichterstellungs-API von Windows Vista (auch als ETW bezeichnet) zum Veröffentlichen von Aktivitätsereignissen in den Jugendschutzprotokollen in Verbindung mit Ereignisdeskriptoren und Arrayenumeration, die in WpcEvent.h definiert sind.

Alle APIs können als Standardbenutzer aufgerufen werden. Für die Protokollierung kann jeder Benutzer Protokollereignisse quellen. Der Aufruf zum Abrufen oder Ändern von Einstellungen für einen anderen Benutzer schlägt fehl, wenn der Aufrufer nicht über Administratorrechte verfügt. Anders ausgedrückt: Ein Standardbenutzer kann nur auf seine eigenen Einstellungen und nur zum Lesen zugreifen.

Einstellungen und Protokollierungs-API-Nutzung werden in den folgenden Abschnitten weiter erläutert:

Entwicklungsumgebung

Die Entwicklung für Jugendschutz erfordert Zugriff auf drei Headerdateien: Wpc.h, WpcApi.h und WpcEvent.h. Wpc.h ist ein Collector, der die Einstellungen der öffentlichen Compliance-API und Ereignisheader enthält, sodass es ausreichend ist, Wpc.h in den Anwendungscode einzuschließen.

Lese-/Schreibberechtigungen für die WMI-API werden durch die Datei Wpcsprov.mof angegeben. Diese Datei wird im WBEM-Unterverzeichnis im Windows System32-Verzeichnis installiert.

Das Microsoft Windows Software Development Kit (SDK) enthält Beispielcode, um den hier gezeigten Beispielcode zu verstärken und einfache befehlszeilengesteuerte Tools für die API-Untersuchung oder Integrationstests bereitzustellen.