mssoapinit Method (Windows Embedded CE 6.0)

1/6/2010

This method initializes the object implementing the ISoapClient interface using the Web Services Description Language (WSDL) file as input. All the operations in the identified service are bound to the ISoapClient object during initialization. Thus, you can call the operations defined in the service using the ISoapClient object.

Syntax

HRESULT mssoapinit( 
  BSTR bstrWSDLFile,
  BSTR bstrServiceName,
  BSTR bstrPort,
  BSTR bstrWSMLFile
);

Parameters

• bstrWSDLFile
  [in] URL of the WSDL file that describes the services offered by the server.

• bstrServiceName
  [in] Optional. Default value is "". The service in the WSDL file that contains the operation specified in the SOAP request. If this parameter is missing, is null, or is an empty string, the mssoapinit method uses the first service in the specified WSDL file when initializing the ISoapClient implementation.

• bstrPort
  [in] Optional. Default value is "". The name of the port in the WSDL file that contains the operation specified in the SOAP request. If this parameter is missing, is null, or is an empty string, the mssoapinit method uses the first port in the specified service when initializing the ISoapClient implementation.

• bstrWSMLFile
  [in] Optional. Default value is "". The URL of the Web Services Meta Language (WSML) file. This is a required parameter only when using custom type mappers, as described in Handling Complex Types.

Return Value

The following table describes the common return values.

Remarks

The mssoapinit method is part of the high-level API on the client side. To use this method, first you simply create an SoapClient object on the client. The SoapClient object implements the ISoapClient interface. Then, you call the mssoapinit method using the WSDL file name, service name, and port name as parameters. Now, the client can call any operations defined in the WSDL file for the requested service or port.

Requirements

See Also

Reference

ISoapClient

Concepts

A Quick Introduction to WSDL
A Quick Introduction to WSML