GenericUCP Sample UPnP Application in C++


Overview:
=========

GenericUCP is a C++ sample UPnP application that discovers and controls 
UPnP devices found on the network.This sample was developed using Visual C++ 
and uses MFC.

The sample application uses the UPnP Control Point API provided by upnp.dll. The 
application can discover devices on the network through one of the three types
of searches available: FindByType, FindByUDN and AsyncFind. 

The devices found are instantiated in the device list. One of the devices can be 
selected and the service objects for the selected device are listed in the service
list. One of the services can be selected and controlled by invoking actions against
it. The events relevant to the service are displayed in the events field. 


Files:
======

deviceprop.cpp	- Implements CDeviceProp which is a dialog box for printing the 
                  IUPnPDevice objects's properties
deviceprop.h 	- Definitions for CDeviceProp class 
devtype.txt	- Device types used by GenericUCP.exe in the dropdown menu
genericucp.cpp 	- Provides the CWinApp implementation for this sample application
genericucp.h	- Definitions for CGenericUCPApp which is derived from CWinApp
genericucp.ico	- Icon file used by this sample application
genericucp.rc	- Resource for this application
GenericUCPDlg.cpp - Demonstrates the use of various UPnP control point APIs
genericucpdlg.h	- Class definitions for the above file
resource.h	- Resource include file
stdafx.cpp	- Source file that includes the standard includes 
stdafx.h	- Standard Include file
udn.txt 	- contains UDNs used by GenericUCP.exe in the dropdown menu
util.cpp	- Utility routines used by this sample
util.h		- Declarations for the utility routines




Building the Sample:
====================

To build the sample using the command prompt:

     1. Open the Command Prompt window and navigate to the GenericUCP directory.
     2. Type 'msbuild genericucp.sln'

To build the sample using Visual Studio 2008 (preferred method):

     1. Open Windows Explorer and navigate to the GenericUCP directory.
     2. Double-click the icon for the genericucp.sln (solution) file to open the file 
        in Visual Studio.
     3. In the Build menu, select Build Solution. The application will be built in the 
        default \Debug or \Release directory.



Running the Sample:
===================

     1. Open a Command Prompt and navigate to the Release or Debug directory under 
        GenericUcp.
     2. Copy the devType.txt and Udn.txt files from the CPP directory to the current
        directory. 
     3. Run GenericUcp.exe. The device types and the UDNs that appear in the drop
	down menu are from devType.txt and Udn.txt respectively.



Comments:
=========

The sample uses most of the UPnP control point APIs. The comments in the code give more 
detail on usage of these APIs. This sample does not show the usage of some of the APIs 
like IUPnPDescriptionDocument interface APIs, IUPnPDeviceDocumentAccess interface APIs, etc.