ISOAPEnvelope::ThrowFaults Property

[propget] HRESULT ThrowFaults([out, retval] VARIANT_BOOL * pVal);
[propput] HRESULT ThrowFaults([in] VARIANT_BOOL newVal);

When ThrowFaults is set to VARIANT_TRUE [the default] the Envelope object will automatically check any SOAP message it parses [via the Parse method] to see if it contains a SOAP fault, in the event that the SOAP message is indeed a SOAP Fault, it will translate the SOAP Fault to a COM error and return that error.

 

Return Values

 

Sample Code

set e = CreateObject("pocketSOAP.Envelope.2")
set t = CreateObject("pocketSOAP.HTTPTransport.2")
....
t.send "http://example.org/", e.serialize
e.ThrowFaults = true
' if the response Message contains a SOAP Fault, the call to Parse will fail with the SOAP Fault error
' if ThrowFaults was set to false, the call to Parse will succeed even if the SOAP message is a SOAP Fault.
e.Parse t

 

See Also

The ISOAPEnvelope Interface | 

 

 

Copyright

Copyright © Simon Fell, 2000-2004. All rights reserved.