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

消息数。

注解

应用程序序列化标头块允许接收方维护包含此标头块的序列消息,尽管它们可能已按顺序接收。 这允许从目标服务正确排序 HelloBye 消息。

应用程序序列标头块的规范性大纲是:

<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 验证规则