Readme - Windows Vista Parental Controls User Interface Extensibility Sample

DESCRIPTION:
The Windows Vista Parental Controls infrastructure provides an extensibility
mechanism for ISV components to register launch links for display on the
central control panel.  Via WMI, the API allows specification of an icon path,
disabled icon path, main text name resource path, and subtitle text resource 
path to show, and an executable path to invoke when the "link" rectangle is 
clicked.

This command line application sample demonstrates code required to list all 
registered links, and query for links meeting a WQL specification.  It also 
shows adding, modifying, and deleting links tagged by GUID as would be 
necessary for real-world software deployment, updates, and uninstallation.
Code implementing each operation is wrapped in a Wpcs (Windows Parental
Controls Sample) prepended function to facilitate experimentation and trial 
integration.

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:
UIExtensibility.cpp 		Implementation file
UIExtensibility.h		Header
UIExtensibility.sln		Solution file
UIExtensibility.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/UIExtensibility
3.  Type "vcbuild UIExtensibility.sln"
This creates the executable in the output subdirectory for the current build
configuration(s).

KEY APIS USED IN THE SAMPLE:
WMI IWbemServices::CreateInstanceEnum()
WMI IEnumWbemClassObject::Next()
WMI IWbemServices::ExecQuery()
WMI IWbemServices::GetObject()
WMI IWbemClassObject::SpawnInstance()
WMI IWbemServices::PutInstance()
WMI IWbemServices::DeleteInstance()

USAGE:

uiextensibility <operation> [argument1..n]

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

list				
-> list registered extensions

query <query_string>		
-> perform query per WMI WQL syntax, listing matches

add /g:<GUID> /c:<subsystem> /n:<name_path> /s:<subtitle_path> /i:<image_path> /d:<disabled_image_path> /e:<exe_path>
-> add new extension keyed by GUID string and subsystem number (currently always 0)

mod /g:<GUID> /c:<subsystem> [/n:<name> /s:<subtitle> /i:<image_path> /d:<disabled_image_path> /e:<exe_path>]
-> modify one or more elements in existing extension, using key of GUID string and subsystem

del /g:<GUILD> /c:<subsystem>
-> delete extension keyed by GUID string and subsystem number

Notes: 
 1.  The subsystem argument is currently always 0.  It is present for future growth
 2.  The name_path, subtitle_path, image_path and disabled_image_path arguments 
     conform to Shell Extensibility standards for a negative resource number in the 
     binary.  As an example, using the WPC control panel DLL a usable image_path 
     would be c:/windows/system32/wpccpl.dll,-20.

Returns:  0 on success, 1 on failure

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