共用方式為

WSD_APP_SEQUENCE 結構 (wsdtypes.h)

  • 發行項

表示與 WS-Discovery 訊息相關的應用程式順序資訊。

語法

typedef struct _WSD_APP_SEQUENCE {
  ULONGLONG   InstanceId;
  const WCHAR *SequenceId;
  ULONGLONG   MessageNumber;
} WSD_APP_SEQUENCE;

成員

InstanceId

執行個體識別碼。

SequenceId

順序識別碼。

MessageNumber

訊息號碼。

備註

應用程式排序標頭區塊可讓接收者維護包含此標頭區塊的序列訊息，不過它們可能已依序接收。 這允許從目標服務正確排序 Hello 和 Bye 訊息。

應用程式順序標頭區塊的規範大綱如下：

<s:Envelope ...> 
  <s:Header ...> 
    <d:AppSequence InstanceId='xs:nonNegativeInteger' [SequenceId='xs:anyURI']? MessageNumber='xs:nonNegativeInteger' ... />
  </s:Header> 
  <s:Body ...> ... 
  </s:Body> 
</s:Envelope>

下列說明此大綱的規範條件約束。

/s:Envelope/s:Header/d:AppSequence/@InstanceId

每次服務終止、遺失狀態及還原時，此設定必須以至少 1 的值遞增。 應用程式可以使用每次重新啟動服務時遞增的計數器來設定此值。 服務的重新啟動時間會以自上午 12：00 起經過的秒數表示。1970 年 1 月 1 日。

/s:Envelope/s:Header/d:AppSequence/@SequenceId

此設定會識別實例識別碼內容中的序列。 如果省略，隱含的值就是 Null 序列。 此設定中的值在 ./@InstanceId內必須是唯一的。

/s:Envelope/s:Header/d:AppSequence/@MessageNumber

此設定會識別序列標識碼和實例標識碼內容中的訊息。 每個傳送的訊息必須以至少 1 的值遞增。 在傳輸層級重新傳輸此訊息必須維持此值。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 wsdtypes.h (包含 Wsdapi.h)

另請參閱

AppSequence 驗證規則