This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Sample Name
===============================
Windows Connect Now - WCN
Demonstrates:
===============================
WCNAPI
Introduction
===============================
Windows Connect Now (WCN) allows you to configure the wireless security on a WCN eanbled Router, discover nearby devices, and join them to the wireless network, all while maintaining a compromise between security and usability. WCN is designed for home users, and is not suitable for enterprise scenarios.
This sample shows the basic usage of the WCNAPI’s to configure a WCN enabled device. This includes devices such as a wireless router or printer. Also, this demonstrates getting a wireless profile from a configured WCN enabled router via the devices' push button.
Sample Language Implementations
===============================
This sample is available in the following language implementations:
C++
Files
===============================
WcnConfigure.cpp – Main entry point for the sample. This is where the command line parsing and the WCNAPI calls originate
WcnConnectNotify.cpp – Helper file that implements the IWCNConnectNotify Interface. WCN uses this interface to notify the application of WCN connection events.
WcnFdHelper.cpp – Helper file that implements and wraps the Function Discovery Interface that is used by WCN to Find a WCN Device.
Prerequisites
===============================
- This sample app needs to run as an elevated user.
- ATL is required to compile this Sample
- Wireless Adapter present on the system.
- Only runs on Windows 7
- This sample is command line only
To build the sample using the command prompt:
===============================
1. Open the Command Prompt window and navigate to the directory.
2. Type msbuild WindowConnectNow.sln
To build the sample using Visual Studio 2005 (preferred method):
===============================
1. Open Windows Explorer and navigate to the directory.
2. Double-click the icon for the .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
===============================
To run the sample:
1. From an elevated command prompt navigate to the directory that contains the new executable.
2. Type the following at the command line, depending on what you want to do.
WCNConfigure.exe – without any options this will display the following usage.
USAGE:
WCNConfigure.exe
Scenario=[DeviceConfigPin | DeviceConfigPushButton | RouterConfig |
PCConfigPushButton | PCConfigPin ]
[UUID=<uuid of device> | SEARCHSSID=<ssid of device to find>]
[PIN=<pin of device>]
[PROFILESSID=<ssid to use in profile>]
[PROFILEPASSPHRASE=<passphrase to use in profile>]
Parameters:
Scenario - choose the operation you wish to perform
DeviceConfigPushButton - Configure a WCN enabled device, such as a picture
frame using the button on the device
DeviceConfigPin - Configure a WCN enabled device, such as a picture frame
using the device supplied pin
RouterConfig - Configure a WCN enabled Wireless Router
PCConfigPushButton - Get the wireless profile from a WCN enabled router
using the Push Button on the device.
PCConfigPin - Get the wireless profile from a WCN enabled rotuer using the
supplied pin.
UUID - Enter a device UUID in the following format xxxx-xxxx-xxxx-xxxxxxxxxxxx
UUID is necessary for the DeviceConfigPushButton and DeviceConfigPin
scenarios. Use either UUID or SEARCHSSID for the RouterConfig, PCConfigPin
and PCConfigPushButton scenarios.
SEARCHSSID - Enter in the SSID for the Router you are looking to configure.
SEARCHSSID is only valid in the RouterConfig, PCConfigPushButton and
PCConfigPin scenarios. Use either UUID or SEARCHSSID for the these
scenarios. NOTE: Using SSID will return the first device
found with that ssid. If there is more than one device with the
same ssid use the UUID instead
PIN - Enter the pin of the device
PIN is only valid when using the RouterConfig and DeviceConfigPIN
Scenarios.
PROFILESSID - When present this SSID will be used in the WLAN profile that is
pushed to the router/device otherwise a default SSID of WCNSSID
will be used
PROFILEPASSPHRASE - when present this passphrase will be used in the wlan
profile that is pushed to the router/device. Otherwise, a
random default passphrase will be used
Example:
===============================
The following will find the Router based on its UUID and configure it using the supplied pin. It will then save the wireless profile it used to configure the router to the system.
C:\>WCNConfigure.exe Scenario=RouterConfig UUID=12345678-1234-1234-1234-123456789012 PIN=12345670
INFO: Stating the Function Discovery Search...
INFO: The following Device was found by Function Discovery.
INFO: Device Name: [Device Name]
INFO: Manufacturer Name: [Manufacturer name]
INFO: Model Name: [Model Name]
INFO: Model Number: [Model number]
INFO: Serial Number: [serial number]
INFO: Successfully saved the profile to the wlan store
INFO: Successfully retrieved profile [WCNSSID] from the wlan store.
INFO: IWCNDevice::SetNetworkProfile() succeeded with result [0x0]
INFO: IWCNDevice::SetPassword succeeded with result [0x0]
INFO: IWCNDevice::Connect succeeded with result [0x0]
INFO: IWCNConnectNotify::ConnectSucceeded was invoked
INFO: Profile SSID Used: [WCNSSID]
INFO: Profile Passphrase Used: [1234-abcd-1d2a]
INFO: Configuration of the Wireless Router Succeeded
