pbRequestOnly - cClientWebService
Determines if the web service's operation is one-way or two-way
Type: Property
Access: Read/Write
Data Type: Boolean
Parameters: None
Syntax
Property Boolean pbRequestOnly
| Access Type | Syntax |
|---|---|
| Read Access: | Get pbRequestOnly to BooleanVariable |
| Write Access: | Set pbRequestOnly to BooleanVariable/Value |
Description
Most web-service operations are two-way, where you send a SOAP request and you get a SOAP response back. An operation may also be one-way, where a SOAP request is sent but no SOAP response is expected. In such a case, the only reply the client receives is the HTTP response, which should only be used to indicate that the request was sent and not whether it was valid. Because of the inflexibility of one-way operations, they are rarely used.
There are actually two types of one-way SOAP operations. An "in-only" sends a SOAP request but never sends a SOAP response. If there is a fault, the service may generate the fault but it is not allowed to send it back as a SOAP response. There is also a "robust in-only" style, where a SOAP response is never sent unless there is a SOAP fault. While it is not clear if robust in-only is actually supported in SOAP 1.1, it seems to be used, and therefore both one-way styles are supported when pbRequestOnly is set to True.
Most web-service operations are two-way (in/out) and the value for pbRequestOnly is set to False. If an operation is one-way, pbRequestOnly is set to True. The Web Service Client Generator determines if a style is one-way or the normal two-way by looking at the service's WSDL. When it generates the code for the web-service operation (i.e., the function or procedure within the sub-class it creates), it will set pbRequestOnly to the proper value.
You should never need to change this property.