Edit

ProbeMatches Message

  • Article

A ProbeMatches message is a WS-Discovery message sent by a service in response to a client's Probe message. For more information about ProbeMatches messages, see section 5.3 of the WS-Discovery Specification.

A ProbeMatches message is sent by UDP unicast to the port from which the client's Probe message was sent. ProbeMatches must be sent within 4 seconds of the Probe message; otherwise, Windows Firewall may drop the packet.

If no XAddrs are included in the ProbeMatches message, then the client may send a Resolve message by UDP multicast to port 3702. The client will only send a Resolve message when an HTTP message (such as a Get metadata exchange request or a service message) will be sent.

Any DPWS application that sends Probe messages will receive ProbeMatches messages.

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 ProbeMatches 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"
    xmlns:wsdp="https://schemas.xmlsoap.org/ws/2006/02/devprof">
<soap:Header>
    <wsa:To>
        https://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous
    </wsa:To>
    <wsa:Action>
        https://schemas.xmlsoap.org/ws/2005/04/discovery/ProbeMatches
    </wsa:Action>
    <wsa:MessageID>
        urn:uuid:967d0036-fe69-40ad-8191-dd1fc8ef64ab
    </wsa:MessageID>
    <wsa:RelatesTo>
        urn:uuid:29cf10da-5c41-4d55-b184-5ee15e38ce23
    </wsa:RelatesTo>
    <wsd:AppSequence InstanceId="1"
        SequenceId="urn:uuid:369a7d7b-5f87-48a4-aa9a-189edf2a8772"
        MessageNumber="9">
    </wsd:AppSequence>
</soap:Header>
<soap:Body>
    <wsd:ProbeMatches>
        <wsd:ProbeMatch>
            <wsa:EndpointReference>
                <wsa:Address>
                    urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
                </wsa:Address>
            </wsa:EndpointReference>
            <wsd:Types>wsdp:Device</wsd:Types>
            <wsd:XAddrs>
                https://192.168.0.2:5357/37f86d35-e6ac-4241-964f-1d9ae46fb366
            </wsd:XAddrs>
            <wsd:MetadataVersion>2</wsd:MetadataVersion>
        </wsd:ProbeMatch>
    </wsd:ProbeMatches>
</soap:Body>
</soap:Envelope>

A ProbeMatches message has the following focus points.

Focus point XML Description
ProbeMatches 
<wsa:Action>
    https://schemas.xmlsoap.org/ws/2005/04/discovery/ProbeMatches
</wsa:Action>
 The ProbeMatches SOAP action identifies the message as a ProbeMatches message.
RelatesTo 
<wsa:RelatesTo>
    urn:uuid:29cf10da-5c41-4d55-b184-5ee15e38ce23
</wsa:RelatesTo>
 The identifier of the message to which the service is responding. This header matches the MessageId in the Probe message.
AppSequence 
<wsd:AppSequence InstanceId="1"
    SequenceId="urn:uuid:369a7d7b-5f87-48a4-aa9a-189edf2a8772"
    MessageNumber="9">
</wsd: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 
<wsa:Address>
    urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
</wsa:Address>
 Contains the endpoint address. This addressed may be referenced in a Resolve message.
XAddrs 
<wsd:XAddrs>
    https://192.168.0.2:5357/37f86d35-e6ac-4241-964f-1d9ae46fb366
</wsd:XAddrs>
 XAddrs are transport addresses that may be used for communication between client and service. Addrs are validated as described in XAddr Validation Rules.

 

Discovery and Metadata Exchange Messages

Probe Message