Summary: This white Paper will guide you through writing a client application that uses the example. NET my Services. The client application will be written using Managed Extensions for C + +, Visual studio®.net, and the. NET my Services Software Development Kit (SDK). You also need to perform a number of other steps than visual c#™ or Visual basic® client applications. This white paper assumes that you are familiar with the Visual Studio XML Web service model, which is used to create and use General Web service from client applications.
Brief introduction
As a microsoft®.net initiative, Microsoft introduced a user-centric architecture and a set of XML Web services (called. NET My service, the previous code named "HailStorm").. NET My Servi Based on the functionality of Microsoft. NET Alerts and Microsoft. NET Passport, CES is a series of XML Web Service that will be available in 2002. At that time, users will be able to securely store personal information and control access to personal information. The. NET my Services platform is a collection of XML Web service that can use industry standard protocols including Simple Object Access Protocol [SOAP], XML, and common description, discovery, and integration [ UDDI]) is invoked over the Internet. NET my Services can authenticate users, send alerts, and store personal information, including contacts, e-mail messages, calendars, profiles, lists, electronic wallets, physical locations, document libraries, application settings, favorite Web sites, owned devices, and preferences to receive alerts.
To encourage developers to develop applications that use these services, Microsoft published the. NET My Services SDK at a professional developer's meeting in October 2001. This SDK contains the sample services and two projects that expose the source code to integrate Visual Studio with. NET My services. These Open-source projects are written in Visual C # and provide visual Studio with additional functionality that enables users to work seamlessly with the specific characteristics of. NET my Services in the following example.
First, you should know that. NET My services uses a central meta service called. NET services to understand this is important. This service acts as an intermediary between clients and other. NET My services, such as. NET Contacts or. NET Wallet. Centralized. NET services can also manage the provision of other services on behalf of the user and communicate the location of other services to the client at run time. Therefore, before determining the address of a particular request, the client application must negotiate the transaction with the hub. NET my services.
. NET my Services also uses the Kerberos authentication protocol and encrypts all SOAP packets to ensure the security of the user's private data. This means that all client applications must provide the ability to request Kerberos authentication orders, and they must be displayed in all SOAP requests. Similarly, the client must be able to encrypt the SOAP request and decrypt the SOAP response.
All the technologies used in. NET My Services locator and encryption are based on open standards and have extensive documentation so that. NET My service developers can develop their own application tiers to handle these features. However, the. NET my Services SDK includes two shared source code projects that can address these issues. For Visual C # and Visual Basic, users can take advantage of these features simply by including references to them in their client applications. Fundamentally, these features allow developers to encode. NET my Services like other XML Web Service.
Note: There are additional measures to address the limitations of the Add Web Reference (Add Web Reference) dialog box for the Managed Extensions for C + + client applications. Where the Managed Extensions for C + + client application uses the XML Web Service (using strongly typed datasets). These additional measures will no longer be required in future versions of Visual Studio. NET. Drill
In this walkthrough, you will build HsSoapExtension.dll from the. NET my Services SDK, create a simple Managed Extensions for C + + client, and use sample client code to your. NET Favoriteweb Sites Add a Web site.
Generate HsSoapExtension.dll
In Visual Studio, open the Integrated development environment (IDE).
On the File menu, click Open, and then click Project.
Browse to the. NET my Services SDK folder and locate the Hssoapextension solution.
Click Open.
On the Build menu, click Build Solution (Generate solution). Note: HsSoapExtension.dll is used later in this walkthrough.
Create a simple Managed Extensions for C + + client
On the File menu, click New, and then click Project.
The New Project dialog box appears.
In the Project Types pane, click Visual C + +, and then in the Templates pane, click Managed C + + application (Manage C + + applications).
In the Name box, enter Myserviceclient.
Click OK (OK).
Locate the Myserviceclient project directory on the command line, and then run the following command:disco http://localhost/WSDL/myFavoriteWebSites.wsdl
This command downloads the soaprp.xsd and myfavoritewebsites.wsdl files and generates RESULTS.DISCOMAP. The generated. discomap file describes the dependencies between the. wsdl and the. xsd file.