Edit

ProbeMatches Message

  • Article
  • 2 minutes to read

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 
\

 



 


Discovery and Metadata Exchange Messages


 


Probe Message