Compartilhar via


Mensagem de investigação

Uma mensagem de investigação é uma mensagem WS-Discovery usada por um cliente para pesquisar serviços na rede por tipo de serviço. Para obter mais informações sobre mensagens de investigação, consulte a seção 5.2 da Especificação WS-Discovery.

Uma mensagem de investigação é enviada por multicast UDP para a porta 3702. Não há suporte para mensagens de investigação Unicast.

Os clientes DPWS enviam mensagens de investigação. A lista a seguir mostra cenários nos quais o WSDAPI enviará uma mensagem de investigação.

  • Os clientes de Descoberta de Funções enviam mensagens de investigação.
  • Clientes WSDAPI que chamam IWSDiscoveryProvider::SearchByAddress enviam mensagens de investigação.
  • Clientes WSDAPI que chamam IWSDiscoveryProvider::SearchByType enviam mensagens de investigação.
  • Os aplicativos que usam a descoberta direcionada enviam mensagens de investigação por HTTP ou HTTPS.

Observação

Este tópico mostra uma mensagem DPWS de exemplo gerada por clientes e hosts WSDAPI. O WSDAPI analisará e aceitará outras mensagens compatíveis com DPWS que não estão em conformidade com este exemplo. Não use este exemplo para verificar a interoperabilidade do DPWS; em vez disso, use a WSDBIT (Ferramenta de Interoperabilidade Básica) do WSDAPI .

 

A mensagem SOAP a seguir mostra uma mensagem de investigação de exemplo.

<?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>
        urn:schemas-xmlsoap-org:ws:2005:04:discovery
    </wsa:To>
    <wsa:Action>
        https://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>

Uma mensagem de investigação tem os seguintes pontos de foco.

Ponto de foco XML Descrição
Investigação
<wsa:Action>
    https://schemas.xmlsoap.org/ws/2005/04/discovery/Probe
</wsa:Action>
A ação De investigação SOAP identifica a mensagem como uma mensagem de investigação.
MessageID
<wsa:MessageID>
    urn:uuid:29cf10da-5c41-4d55-b184-5ee15e38ce23
</wsa:MessageID>
Contém o identificador de mensagem, que é referenciado pelo elemento RelatesTo em uma mensagem ProbeMatches .
Tipos
<wsd:Types>wsdp:Device
Contém os tipos de WS-Discovery para os quais o cliente está pesquisando. Esse elemento não deve estar vazio.

 

Mensagens de descoberta e troca de metadados

Mensagem ProbeMatches