Uso delle API dei controlli genitori
Selezione API
Come indicato nella sezione panoramica, lo sviluppo prevede l'uso di fino a tre API:
- Accesso alle impostazioni di base: l'API COM di conformità minima dei controlli genitori (API conformità) definita in Wpcapi.h per l'accesso semplice a un sottoinsieme chiave dello stato dei controlli parentali.
- Accesso in lettura/scrittura delle impostazioni complete: l'uso di un piccolo subset dell'API COM WMI per l'accesso completo è necessario solo se l'ISV deve modificare le impostazioni. L'aggiunta di un collegamento di estendibilità dell'interfaccia utente, la sostituzione del filtro contenuto Web o le aggiunte all'applicazione HTTP a livello di computer o agli elenchi di esenzione del filtro URL sono i motivi principali per l'uso dell'API. Poiché l'utilizzo dello spazio dei nomi di WMI Parental Controls fornisce l'accesso non elaborato all'archivio delle impostazioni sottostanti, gli ISV devono procedere con cautela nell'interpretare lo stato da singole impostazioni che potrebbero infatti avere dipendenze ginging su altre impostazioni. È quindi consigliabile usare l'API conformità per la lettura dello stato per tutti i valori esposti da tale API.
- Registrazione: l'API di sistema di traccia eventi e creazione di report di Windows Vista (denominata anche ETW) per la pubblicazione degli eventi nei log dei controlli genitori, insieme ai descrittori di eventi e alle enumerazioni di matrice definite in WpcEvent.h.
Tutte le API sono chiamabili come utente standard. Per la registrazione, qualsiasi utente può creare eventi di log di origine. La chiamata a recuperare o modificare le impostazioni per un altro utente avrà esito negativo se il chiamante non dispone dei privilegi di amministratore. In altre parole, un utente standard può accedere solo alle proprie impostazioni e solo per la lettura.
Le impostazioni e l'utilizzo dell'API di registrazione vengono illustrate ulteriormente in queste sezioni:
- Uso delle API impostazioni dei controlli genitori
- Uso delle API di registrazione per i controlli genitori
Ambiente di sviluppo
Lo sviluppo per i controlli genitori richiede l'accesso a tre file di intestazione: Wpc.h, WpcApi.h e WpcEvent.h. Wpc.h è un agente di raccolta che include le impostazioni api di conformità pubblica e intestazioni di eventi, quindi è sufficiente includere Wpc.h nel codice dell'applicazione.
Le autorizzazioni di lettura/scrittura per l'API WMI sono specificate dal file Wpcsprov.mof. Questo file viene installato nella sottodirectory WBEM nella directory Windows System32.
Microsoft Windows Software Development Kit (SDK) contiene codice di esempio per rafforzare il codice di esempio illustrato qui e fornire semplici strumenti basati sulla riga di comando per l'esplorazione dell'API o i test di integrazione.