Probe Message

A Probe message is a WS-Discovery message used by a client to search for services on the network by service type. For more information about Probe messages, see section 5.2 of the WS-Discovery Specification.

A Probe message is sent by UDP multicast to port 3702. Unicast Probe messages are not supported.

DPWS clients send Probe messages. The following list shows scenarios in which WSDAPI will send a Probe message.

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 Probe message.

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope
    xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
    xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing"
    xmlns:wsd="http://schemas.xmlsoap.org/ws/2005/04/discovery"
    xmlns:wsdp="http://schemas.xmlsoap.org/ws/2006/02/devprof">
<soap:Header>
    <wsa:To>
        urn:schemas-xmlsoap-org:ws:2005:04:discovery
    </wsa:To>
    <wsa:Action>
        http://schemas.xmlsoap.org/ws/2005/04/discovery/Probe
    </wsa:Action>
    <wsa:MessageID>
        urn:uuid:29cf10da-5c41-4d55-b184-5ee15e38ce23
    </wsa:MessageID>
</soap:Header>
<soap:Body>
    <wsd:Probe>
        <wsd:Types>wsdp:Device</wsd:Types>
    </wsd:Probe>
</soap:Body>

A Probe message has the following focus points.

Focus pointXMLDescription
Probe
<wsa:Action>
    http://schemas.xmlsoap.org/ws/2005/04/discovery/Probe
</wsa:Action>
The Probe SOAP action identifies the message as a Probe message.
MessageID
<wsa:MessageID>
    urn:uuid:29cf10da-5c41-4d55-b184-5ee15e38ce23
</wsa:MessageID>
Contains the message identifier, which is referenced by the RelatesTo element in a ProbeMatches message.
Types
<wsd:Types>wsdp:Device</wsd:Types>
Contains the WS-Discovery types for which the client is searching. This element should not be empty.

 

Related topics

Discovery and Metadata Exchange Messages
ProbeMatches Message

 

 

Community Additions

ADD
Show:
© 2014 Microsoft