プローブ メッセージ
プローブ メッセージは、クライアントがサービスの種類別にネットワーク上のサービスを検索するために使用するWS-Discovery メッセージです。 プローブ メッセージの詳細については、 WS-Discovery 仕様のセクション 5.2 を参照してください。
プローブ メッセージは UDP マルチキャストによってポート 3702 に送信されます。 ユニキャスト プローブ メッセージはサポートされていません。
DPWS クライアントはプローブ メッセージを送信します。 次の一覧は、WSDAPI がプローブ メッセージを送信するシナリオを示しています。
- 関数探索クライアントはプローブ メッセージを送信します。
- IWSDiscoveryProvider::SearchByAddress を呼び出す WSDAPI クライアントは、プローブ メッセージを送信します。
- IWSDiscoveryProvider::SearchByType を呼び出す WSDAPI クライアントは、プローブ メッセージを送信します。
- ダイレクト検出を使用するアプリケーションは、HTTP または HTTPS 経由でプローブ メッセージを送信します。
Note
このトピックでは、WSDAPI クライアントとホストによって生成される DPWS メッセージのサンプルを示します。 WSDAPI は、このサンプルに準拠していない他の DPWS 準拠メッセージを解析して受け入れます。 DPWS の相互運用性を確認するには、このサンプルを使用しないでください。代わりに WSDAPI 基本相互運用性ツール (WSDBIT) を使用してください。
次の SOAP メッセージは、プローブ メッセージのサンプルを示しています。
<?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>
プローブ メッセージには、次のフォーカス ポイントがあります。
フォーカス ポイント | XML | 説明 |
---|---|---|
プローブ |
|
Probe SOAP アクションは、メッセージをプローブ メッセージとして識別します。 |
MessageID |
|
ProbeMatches メッセージの RelatesTo 要素によって参照されるメッセージ識別子を格納します。 |
種類 |
|
クライアントが検索するWS-Discoveryの種類を格納します。 この要素は空にしないでください。 |
関連トピック