Ack for Cancel-Session
使用 Ack for Cancel-Session 数据包来确认客户端的 Cancel-Session 请求。 服务器在释放与上传会话关联的所有资源后发送确认。
reason-code reason-description
BITS-Packet-Type: Ack
BITS-Session-Id: {guid}
Content-Length: length
BITS-Error-Code: error-code
BITS-Error-Context: error-context
标头
-
reason-code
-
将 reason-code 替换为 HTTP 原因代码。 例如,如果成功,请将原因代码设置为 200。 有关 HTTP 原因代码的列表,请参阅 RFC 2616。
-
reason-description
-
将 reason-description 替换为与原因代码关联的 HTTP 说明。 例如,如果 reason-code 为 200,请将 reason-description 设置为 OK。
-
BITS-Packet-type
-
将此响应数据包标识为 Ack 数据包。
-
BITS-Session-Id
-
标识客户端会话的字符串 GUID。 将 {guid} 替换为客户端在 取消会话 请求数据包中发送的会话标识符。 如果无法识别会话标识符,请将 BITS-Error-Code 标头设置为 BG_E_SESSION_NOT_FOUND。
-
Content-Length
-
将 length 替换为响应正文中包含的字节数。 即使响应的正文不包含内容,也是必需的。
-
BITS-Error-Code
-
将错误代码替换为表示与服务器端错误关联的 HRESULT 值的十六进制数。 仅当原因代码不是 200 或 201 时,才包含此标头。
-
BITS-Error-Context
-
将 error-context 替换为表示发生错误的上下文的十六进制数。 如果服务器生成了错误,请指定 BG_ERROR_CONTEXT_REMOTE_FILE (0x5) 的十六进制数。 否则,如果错误是由上传文件传递到的应用程序生成的,则指定 BG_ERROR_CONTEXT_REMOTE_APPLICATION (0x7) 的十六进制数。 仅当原因代码不是 200 或 201 时,才包含此标头。
备注
如果 reason-code 在 500 到 599 的范围内,BITS 客户端将重新发送 Cancel-Session 数据包,除非 BITS-Error-Code 标头的值为 BG_E_SESSION_NOT_FOUND。 客户端不会出于原因代码 100 到 499 重试。
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈