ProtocolCapabilities 元素 (XMLA)

在 SOAP 要求訊息中使用 SOAP 標頭，以便識別 Microsoft SQL Server Analysis Services 執行個體與用戶端應用程式之間的通訊協定功能。

**命名空間：**https://schemas.microsoft.com/analysisservices/2003/engine

語法

<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      ...
      <ProtocolCapabilities xmlns="https://schemas.microsoft.com/analysisservices/2003/engine">
         <Capability>...</Capability>
      </ProtocolCapabilities>
      ...
   </soap:Header>
   <soap:Body>
      ...
   </soap:Body>
</soap:Envelope>

元素特性

特性	描述
資料類型和長度	無
預設值	無
基數	0-1: 只能出現一次的選擇性元素。

元素關聯性

關聯性	元素
父元素	無
子元素	Capability

備註

ProtocolCapabilities 元素可讓用戶端應用程式隨時與 Analysis Services 執行個體交涉通訊協定功能，例如二進位 XML 或壓縮支援。通訊協定交涉包含下列步驟：

1. 用戶端應用程式透過傳送包含 ProtocolCapabilities 元素當做 SOAP 標頭一部分的 SOAP 要求，識別其通訊協定功能。

2. Analysis Services 執行個體收到並處理此 SOAP 要求。

3. 如果 Analysis Services 執行個體與提出要求的應用程式具有相同的通訊協定功能，此執行個體就會傳送 SOAP 回應 (包含 SOAP 要求中傳送的相同 ProtocolCapabilities 元素)，表示通訊協定已經成功交涉。否則，通訊協定功能不會成功交涉，而且此執行個體會傳回 SOAP 錯誤。

成功交涉通訊協定功能之後，用戶端應用程式與 Analysis Services 執行個體使用特定通訊協定的時間長度會因工作階段是明確或隱含而不同：

• 明確工作階段是指使用 BeginSession 標頭元素所建立的工作階段。若為明確工作階段，交涉的通訊協定就會一直使用到用戶端應用程式傳送新的 ProtocolCapabilities 元素或工作階段結束為止。

• 隱含工作階段是指 Analysis Services 執行個體所建立而且用戶端應用程式在提交 SOAP 要求時並未明確指定的工作階段。若為隱含工作階段，交涉的通訊協定就只會使用到 SOAP 要求完成為止。

通訊協定功能不需要明確交涉。也就是說，用戶端應用程式不需要在 SOAP 要求中包含 ProtocolCapabilities 元素。如果 SOAP 要求沒有包含 ProtocolCapabilities 元素，Analysis Services 執行個體就會使用與 SOAP 要求相同的格式進行回應。

請參閱

概念

管理連接與工作階段 (XMLA)

其他資源

標頭 (XMLA)