Readme - Windows Vista Parental Controls Web Extensibility Sample

DESCRIPTION:
The Windows Vista Parental Controls infrastructure provides an extensibility
mechanism for ISV components to register an alternate web content filter 
overriding the filter provided with Vista, as only one filter should be 
active at any time.

This command line application sample demonstrates code required to get and 
set the FilterID and FilterNamePath properties necessary for registration.  It 
also exposes management of two exemption lists for overriding filtering for
entire applications or URLs matching specified strings to the length of 
those strings.

Note that the FilterID GUID used for a web content filter override must have
been registered as a User Interface extensibility link as shown in the 
UIExtensibility sample.  Setting the FilterID property to the same GUID as 
for the registered UI link will promote the link from a generic UI extension
to the exclusive active web content filter position.  Resetting this override
requires returning the FilterID to the NULL_GUID value and the FilterNamePath
to a null variant.

The FilternamePath is a string consisting of a path to a resource DLL with ","
and a negative resource ID appended.  This promotes localized binary deployments.

PLATFORM:
The Parental Controls runtimes require Windows Vista, and are only deployed
on consumer (non-business) SKUs.  Programmatic detection of supported SKUs is
provided in the documentation.

FILES:
WebExtensibility.cpp 		Implementation file
WebExtensibility.h		Header
WebExtensibility.sln		Solution file
WebExtensibility.vcproj		Project file

The project has a dependency on the Utilities.lib static library project in 
the Utilities peer directory.

REQUIREMENTS:
No ATL or MFC dependencies are present.  The sample may be built with either
the Windows SDK environment or Visual C++. 


BUILD INSTRUCTIONS:
To build with the Windows SDK:
1.  From the Start->All Programs menu choose Microsoft Windows SDK -> CMD Shell
2.  In the WinSDK CMD Shell, navigate to: 
	Samples/Security/ParentalControls/WebExtensibility
3.  Type "vcbuild WebExtensibility.sln"
This creates the executable in the output subdirectory for the current build
configuration(s).

KEY APIS USED IN THE SAMPLE:
WMI IWbemServices::GetObject()
WMI IWbemServices::PutInstance()

USAGE:

webextensibility <operation> [argument1..n]

where operations, associated arguments,and descriptions are as follows:

http list				
-> list system-wide exemption paths for http-based applications

http add <path>
-> add an application exemption path to the list

http delete <path>
-> delete the specified application exemption path from the list

url list
-> list strings to be matched to appropriate substring length in a URL

url add <URL>
-> add string to URL list

url delete <URL>
-> remove string from URL list

filter get
-> display current filter ID and name path.  ID composed of 0's and NULL name 
   path denote the Windows Vista in-box filter

filter set /g:<FilterID> /n:<FilterNamePath>
-> set overriding filter by specifying ID and name path.  This is used in 
   conjunction with the UIExtensibility sample link registration to have a 
   web content filter link displayed at the top of the More Settings region

filter reset
-> return filter ID and name path to settings enabling the Windows Vista provided
   web content filter for the user

Returns:  0 on success, 1 on failure


DOCUMENTATION:
Refer to the Parental Controls for Windows Vista topic under the Security node.