GetJobElementsRequest 元素

所需的 GetJobElementsRequest 元素请求与 JobId 元素标识的作业相关的信息。

使用情况

<wscn:GetJobElementsRequest>
  child elements
</wscn:GetJobElementsRequest>

特性

没有属性。

子元素

元素

JobId

RequestedElements

父元素

没有父元素。

备注

WSD 扫描服务必须支持 GetJobElementsRequest 操作。

客户端可以调用 GetJobElementsRequest 来确定 JobId 标识的作业与作业相关的元素的值。 WSD 扫描服务必须使用 GetJobElementsResponse 进行响应。 扫描服务返回的信息必须完全符合架构的扫描作业相关部分。

此操作可以返回所有常见的 WSD 扫描服务操作错误代码。 若要详细了解如何报告错误,请参阅 WSD 扫描服务操作错误报告

GetJobElementsRequest 可能还返回以下错误。

  • ClientErrorJobIdNotFound

    扫描程序找不到与 JobId 值匹配的作业,或者 JobId 值不在定义的范围内。

    Fault 属性 定义
    [代码] soap:Sender
    [子代码] wscn:ClientErrorJobIdNotFound
    [原因] 找不到指定的 JobId。
    [详细信息] JobId:JobId 不正确

示例

下面的代码示例请求 Fault 属性 1 标识的扫描作业的状态。

<?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/2003/03/addressing"
  xmlns:wscn="https://schemas.microsoft.com/windows/2006/01/wdp/scan"
  soap:encodingStyle='https://www.w3.org/2002/12/soap-encoding' >

  <soap:Header>
    <wsa:To>AddressofScannerService</wsa:To>
    <wsa:Action>
      https://schemas.microsoft.com/windows/2006/01/wdp/scan/GetJobElements
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
  </soap:Header>

  <soap:Body>
    <wscn:GetJobElements>
      <wscn:JobId>1</wscn:JobId>
      <wscn:RequestedElements>
        <wscn:Name>JobStatus</wscn:Name>
      </wscn:RequestedElements>
    </wscn:GetJobElements>
  </soap:Body>
</soap:Envelope>

另请参阅

GetJobElementsResponse

JobId

RequestedElements