SUMMARY
=======
The StockQuote sample demonstrates the basic use of the Web Services on
Devices API. StockQuote implements the functionality described by
StockQuote.wsdl and StockQuoteService.wsdl. The sample includes both a
client and service.
FILES
=====
Supplied files
--------------
ReadMe.txt This readme file
StockQuoteContract\CodeGen_All.config Config file for this sample
StockQuoteContract\CodeGen_Client.config Alternate config file (see note at end)
StockQuoteContract\CodeGen_Host.config Alternate config file (see note at end)
StockQuoteContract\StockQuote.wsdl StockQuote Contract
StockQuoteContract\StockQuoteService.wsdl Service and binding for StockQuote contract
StockQuoteContract\StockQuote.xsd Schema types for StockQuote contract
StockQuoteService\Service.cpp Service Implementation
StockQuoteService\Service.h Header for Service Implementation
StockQuoteClient\Client.cpp Client Implementation
StockQuoteClient\Client.h Header for Client Implementation
Generated files
---------------
These files are generated automatically by WsdCodeGen.exe, but are
included in the sample for reference. You may rebuild these files by
building the StockQuoteContract project.
StockQuoteContract\StockQuote.idl Interface file
StockQuoteContract\[StockQuote.h] Header file built from StockQuote.idl
StockQuoteContract\StockQuoteProxy.cpp Proxy class implementations
StockQuoteContract\StockQuoteProxy.h Proxy class definitions
StockQuoteContract\StockQuoteStub.cpp Stub function implementations
StockQuoteContract\StockQuoteTypes.cpp Type definitions
StockQuoteContract\StockQuoteTypes.h Type declarations and structure definitions
PLATFORMS SUPORTED
==================
Windows Vista
Windows Server 2008
Windows 7
Windows Server 2008 R2
RUNNING THE SERVER AND CLIENT APPLICATIONS
==========================================
To build, type "nmake" at the command line in this directory.
The client and service applications can run on the same Microsoft Windows Vista
computer or a different one.
To run the service type:
StockQuoteService.exe
To run the client type:
StockQuoteClient.exe <device ID> (where <device ID> is the ID printed
by StockQuoteService.exe)
LAYOUT OF CLASSES AND FUNCTIONS
===============================
Service classes and functions
-----------------------------
CStockQuoteService Implements the IStockQuote interface, which matches
the StockQuote port type. This class acts like
a COM object (i.e., has AddRef, Release, and
QueryInterface methods) and also exposes the
GetLastTradePrice method, which can be accessed
across the wire.
StockLookup Function for generating stock prices. This is an
unsophisticated dummy function to demonstrate
basic service functionality.
wmain Main function for processing command-line arguments
and building a device host which advertises a
StockQuote service.
Client classes and functions
----------------------------
wmain Main function for processing command-line arguments,
creating a proxy for sending service messages to a
StockQuote service, and finally invoking the
GetLastTradePrice method on a service.
ALTERNATE CODEGEN CONFIG FILES
==============================
Three config files are included with this sample.
* CodeGen_All.config Default, includes both host and client options
* CodeGen_Client.config Client-only options
* CodeGen_Host.config Host-only options
Only the first of these (CodeGen_All.config) is used when generating code
for the StockQuote sample. CodeGen_Client.config and CodeGen_Host.config
are provided to illustrate how to generate code for only the client and
only the host.
If you would like to use these alternate config files, follow these steps:
1) Run WsdCodeGen.exe /generatecode [alternate config file] /gbc
2) Rebuild the StockQuoteContract project, and then rebuild either the
StockQuoteClient or StockQuoteService project.
