Использование API родительских элементов управления

Выбор API

Как отмечалось в разделе обзора, разработка включает использование до трех API:

• Базовый доступ к параметрам: минимальный API COM для соблюдения требований родительского контроля, определённый в файле Wpcapi.h для простого доступа к ключевому подмножеству состояния родительского контроля.
• Полный доступ на запись и чтение: использование небольшого подмножества COM-API WMI для полного доступа требуется только в том случае, если ISV необходимо изменить параметры. Добавление ссылки расширения пользовательского интерфейса, замена фильтра веб-содержимого или добавление списков исключений по протоколу HTTP на уровне компьютера или URL-адресов являются основными причинами использования API. Поскольку использование пространства имен родительского контроля WMI обеспечивает необработанный доступ к базовому хранилищу параметров, поставщики программного обеспечения должны соблюдать осторожность при интерпретации состояния из отдельных параметров, которые могут на самом деле содержать зависимости от других параметров. Поэтому рекомендуется использовать API соответствия требованиям для чтения всех значений, предоставляемых этим API.
• Ведение журнала: API системы трассировки событий и отчетов Windows Vista (также называемый ETW) для публикации событий действий в журналах родительского контроля в сочетании с дескрипторами событий и перечислениями массивов, определенными в 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 или тестирования интеграции.