共用方式為

取得 (中繼資料交換) HTTP 要求和訊息

  • 發行項

取得訊息是用來要求中繼資料的WS-Transfer訊息。 如需取得訊息的詳細資訊，請參閱 WS 傳輸規格的 3.1 節。 因為中繼資料交換是透過 HTTP 完成，所以 Get 訊息是 HTTP 要求的承載。

DPWS 用戶端會傳送取得訊息。 函式探索用戶端、呼叫 WSDCreateDeviceProxy 的 WSDAPI用戶端，以及呼叫 WSDCreateDeviceProxyAdvanced 的 WSDAPI 用戶端會傳送此訊息。

注意

本主題顯示 WSDAPI 用戶端和主機所產生的 DPWS 訊息範例。 WSDAPI 會剖析並接受不符合此範例的其他 DPWS 相容訊息。 請勿使用此範例來驗證 DPWS 互通性;請改用 WSDAPI 基本互通性工具 (WSDBIT) 。

 

下列範例示範取得 HTTP 要求的範例。

POST /37f86d35-e6ac-4241-964f-1d9ae46fb366
HTTP/1.1
Content-Type: application/soap+xml
User-Agent: WSDAPI
Host: 192.168.0.2:5357
Content-Length: 658
Connection: Keep-Alive
Cache-Control: no-cache
Pragma: no-cache

取得 HTTP 要求具有下列重點。

對焦點 頁首行 Description
URL 路徑 
POST /37f86d35-e6ac-4241-964f-1d9ae46fb366
 發佈取得 HTTP 要求的 URL 路徑。
主機和埠 
Host: 192.168.0.2:5357
 導向取得 HTTP 要求的主機和埠。

 

下列 SOAP 訊息顯示範例 Get 訊息。

<?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">
<soap:Header>
    <wsa:To>
        urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
    </wsa:To>
    <wsa:Action>
        https://schemas.xmlsoap.org/ws/2004/09/transfer/Get
    </wsa:Action>
    <wsa:MessageID>
        urn:uuid:027bec45-c37c-466c-936c-68f648abe2bb
    </wsa:MessageID>
    <wsa:ReplyTo>
        <wsa:Address>
            https://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous
        </wsa:Address>
    </wsa:ReplyTo>
    <wsa:From>
        <wsa:Address>
            urn:uuid:49e131df-351a-4ece-9a6f-6a862d31cffa
        </wsa:Address>
    </wsa:From>
</soap:Header>
<soap:Body>
</soap:Body>

Get 訊息具有下列焦點。

對焦點 XML 描述
收件者 
<wsa:To>
    urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
</wsa:To>
 要求中繼資料之裝置的識別碼。
Get 
<wsa:Action>
    https://schemas.xmlsoap.org/ws/2004/09/transfer/Get
取得 SOAP 動作會將訊息識別為 Get 訊息。
MessageID 
<wsa:MessageID>
    urn:uuid:027bec45-c37c-466c-936c-68f648abe2bb
包含訊息識別碼，這是 在 GetResponse 訊息中參考的。

 

探索和中繼資料交換訊息

GetResponse 訊息