Bye Message
A Bye message is a WS-Discovery message used to announce the departure of a device or service from the network. For more information about Bye messages, see section 4.2 of the WS-Discovery Specification.
Bye messages are unsolicited. The messages are optional.
Note
This topic shows a sample DPWS message generated by WSDAPI clients and hosts. WSDAPI will parse and accept other DPWS-compliant messages that do not conform to this sample. Do not use this sample to verify DPWS interoperability; use the WSDAPI Basic Interoperability Tool (WSDBIT) instead.
The following SOAP message shows a sample Bye message.
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope
xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing"
xmlns:wsd="https://schemas.xmlsoap.org/ws/2005/04/discovery">
<soap:Header>
<wsa:To>
urn:schemas-xmlsoap-org:ws:2005:04:discovery
</wsa:To>
<wsa:Action>
https://schemas.xmlsoap.org/ws/2005/04/discovery/Bye
</wsa:Action>
<wsa:MessageID>
urn:uuid:193ccfa0-347d-41a1-9285-f500b6b96a15
</wsa:MessageID>
<wsd:AppSequence InstanceId="2"
SequenceId="urn:uuid:369a7d7b-5f87-48a4-aa9a-189edf2a8772"
MessageNumber="21">
</wsd:AppSequence>
</soap:Header>
<soap:Body>
<wsd:Bye>
<wsa:EndpointReference>
<wsa:Address>
urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
</wsa:Address>
</wsa:EndpointReference>
</wsd:Bye>
</soap:Body>
A Bye message has the following focus points.
| Focus point | XML | Description |
|---|---|---|
| Bye | |
The Bye SOAP action identifies the message as a Bye message. |
| AppSequence | |
Contains application sequencing information, which helps to maintain the sequence of messages even if they are received out of order. The AppSequence is validated as described in AppSequence Validation Rules. |
| Address | |
Contains the address of the endpoint going offline. |
Related topics