DOCUMENT:Q305965  10-MAR-2002  [vbwin]
TITLE   :HOW TO:Consume XML Web Service Methods by Using SOAP Toolkit 2.0
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER::2.0,4.0,6.0,6.0 SP5
OPER/SYS:
KEYWORDS:kbAudDeveloper kbHOWTOmaster

======================================================================

-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Visual Basic Enterprise Edition for Windows, versions 6.0, 6.0 SP5 
 - Microsoft XML, version 4.0 
 - Microsoft SOAP Toolkit, version 2.0 
-------------------------------------------------------------------------------

IN THIS TASK
------------

 - SUMMARY

    - Create an Application in Visual Basic
 - Troubleshooting


SUMMARY
=======

This step-by-step article describes how to make simple calls to an XML Web
service by using Simple Object Access Protocol (SOAP) Toolkit version 2.0.

Create an Application in Visual Basic
-------------------------------------

1. Download and install the SOAP Toolkit from the following Microsoft Developer
   Network (MSDN) Web site:

   http://msdn.microsoft.com/downloads/default.asp?URL=/code/sample.asp?url=/msdn-files/027/001/580/msdncompositedoc.xml

   This includes downloads for the Toolkit, the Toolkit samples, and a merge
   module for redistributing the underlying objects that you can include with
   the setup program for your application.

2. Make a local copy of the Web Services Description Language (WSDL) file.

NOTE: Although this step is not required, you should make a copy on your local
computer. It is possible to specify the URL for the WSDL on the remote server,
but it can be more convenient to copy the file locally.

3. In your Visual Basic project, add a reference to the Microsoft SOAP Type
   Library. To do this, select References on the Project menu, and then be sure
   that Microsoft Soap Type Library is selected in the list. Click OK.

4. Create an instance of the SoapClient object, as follows:

   Dim oSoapClient As New MSSOAPLib.SoapClient

5. Initialize the SoapClient object with the WSDL file that you copied in Step 2
   by using the mssoapinit method, as follows:

   oSoapClient.mssoapinit "C:\CLIENTWSDLS\CALC.WSDL", "Calc", "CalcSoapPort"

   The first parameter is the path to the WSDL file. The second parameter is the
   value of the name attribute for the service element in the WSDL file that
   corresponds to the XML Web service that you want to call. The third parameter
   is the port type for the service element that corresponds to the XML Web
   service that you want to call. This parameter indicates the type of
   connection that will be made to the XML Web service.

6. Call the XML Web service method by using the SoapClient object as if it were
   a method that is exposed by the SoapClient object itself. For example, if you
   attempt to call an XML Web service method called Add that takes two integers
   as parameters, your code may resemble the following:

   Dim Sum As Integer
   Sum = oSoapClient.Add(3, 4)

7. Build and run the program.

Troubleshooting
---------------

If the methods require complex parameters, you may need to handle them
differently. For more information, see the "Handling Complex Types" topic in the
online documentation for SOAP Toolkit 2.0.


Additional query words:

======================================================================
Keywords          : kbAudDeveloper kbHOWTOmaster 
Technology        : kbVBSearch kbAudDeveloper kbZNotKeyword6 kbMSXMLSearch kbZNotKeyword2 kbVB600Search kbVB600 kbSOAPTK200 kbVB600SP5 kbMSXML400
Version           : :2.0,4.0,6.0,6.0 SP5
Issue type        : kbhowto

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 2002.