NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

SoapClientProtocol.BeginInvoke

Starts an asynchronous invocation of a method of a SOAP web service.

[Visual Basic]
Protected Function BeginInvoke( _
   ByVal methodName As String, _
   ByVal parameters() As Object, _
   ByVal callback As AsyncCallback, _
   ByVal asyncState As Object _
) As IAsyncResult
[C#]
protected IAsyncResult BeginInvoke(
   string methodName,
   object[] parameters,
   AsyncCallback callback,
   object asyncState
);
[C++]
protected: IAsyncResult* BeginInvoke(
   String* methodName,
   Object* parameters[],
   AsyncCallback* callback,
   Object* asyncState
);
[JScript]
protected function BeginInvoke(
   methodName : String,
   parameters : Object[],
   callback : AsyncCallback,
   asyncState : Object
) : IAsyncResult;

Parameters

methodName
The name of the method in the derived class that is invoking BeginInvoke.
parameters
[To be supplied.]
callback
[To be supplied.]
asyncState
[To be supplied.]

Return Value

An IAsyncResult which is passed to EndInvoke to obtain the return values from the remote method call.

Exceptions

Exception Type Condition
SoapException The request reached the server machine, but was not processed successfully.

Remarks

The methodName is used to find the types of the parameters and return values of the method that is invoking BeginInvoke. It is also used to find custom attributes which may have been added to the method. SoapMethodAttribute, SoapParameterAttribute, and SoapReturnAttribute provide additional information on the derived method which is required for the SOAP protocol.

asyncState is passed into callback and is included in the IAsyncResult that is returned from BeginInvoke. It is useful for passing information from the context of the asynchronous call to the handling of the asynchronous result in callback.

See Also

SoapClientProtocol Class | SoapClientProtocol Members | System.Web.Services.Protocols Namespace | IAsyncResult