Использование API родительского контроля
Выбор API
Как отмечалось в разделе обзора, разработка предполагает использование до трех API:
- Доступ к основным параметрам: COM API минимального соответствия родительского контроля (API соответствия), определенный в Wpcapi.h для простого доступа к ключевому подмножество состояния родительского контроля.
- Доступ на запись и чтение с полными параметрами. Использование небольшого подмножества COM API WMI для полного доступа требуется только в том случае, если независимого поставщика программного обеспечения необходимо изменить параметры. Главными причинами использования API являются добавление ссылки на расширяемость пользовательского интерфейса, замена фильтра веб-содержимого или добавление в приложение HTTP на уровне компьютера или списки исключений фильтрации URL-адресов. Так как использование пространства имен родительского контроля WMI предоставляет необработанный доступ к базовому хранилищу параметров, независимым поставщикам программного обеспечения следует действовать с осторожностью при интерпретации состояния отдельных параметров, которые на самом деле могут иметь зависимости от других параметров. Поэтому рекомендуется использовать API соответствия для чтения состояния для всех значений, предоставляемых этим API.
- Ведение журнала: API системы трассировки событий и отчетов Windows Vista (также называемый трассировкой событий Windows) для публикации событий в журналах родительского контроля в сочетании с дескрипторами событий и перечислениями массивов, определенными в WpcEvent.h.
Все API можно вызывать как обычный пользователь. Для ведения журнала любой пользователь может использовать источник событий журнала. Вызов для получения или изменения параметров для другого пользователя завершится ошибкой, если вызывающий объект не имеет прав администратора. Иными словами, обычный пользователь может получить доступ только к своим параметрам и только для чтения.
Параметры и использование API ведения журнала рассматриваются далее в следующих разделах:
- Использование API параметров родительского контроля
- Использование API ведения журнала для родительского контроля
Среда разработки
Для разработки для родительского контроля требуется доступ к трем файлам заголовков: Wpc.h, WpcApi.h и WpcEvent.h. Wpc.h — это сборщик, включающий общедоступный API соответствия параметрам и заголовки событий, поэтому достаточно включить Wpc.h в код приложения.
Разрешения на чтение и запись для API WMI задаются в файле Wpcsprov.mof. Этот файл устанавливается в подкаталог WBEM в каталоге Windows System32.
Пакет средств разработки программного обеспечения Microsoft Windows (SDK) содержит пример кода для усиления примера кода, показанного здесь, и предоставляет простые средства на основе командной строки для изучения API или тестирования интеграции.