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.
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.
||The ProbeMatches SOAP action identifies the message as a ProbeMatches message.|
||The identifier of the message to which the service is responding. This header matches the MessageId in the Probe 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.|
||Contains the endpoint address. This addressed may be referenced in a Resolve message.|
||XAddrs are transport addresses that may be used for communication between client and service. Addrs are validated as described in XAddr Validation Rules.|