sqloptions:sqlSession ヘッダー要素
sqloptions:sqlSession オプションが含まれていて、SOAP ヘッダーとして使用されると、クライアントが要求のセッションを制御できます。
ヘッダーは sqloptions:sqlSession という 1 つの要素で構成されます。この要素には、initiate、terminate、sessionId、timeout、および transactionDescriptor という 5 つの省略可能な属性があります。各属性の使用と動作の詳細については、「SOAP セッションを使用した作業」を参照してください。
sqloptions:sqlSession オプションのインスタンスは、1 回の要求または応答で 1 つだけ使用できます。このオプションが複数存在するとエラーが発生します。
次に、スキーマの sqloptions:sqlSession オプションに関する部分を示します。
<xs:element name="sqlSession form="qualified">
<xs:annotation>
<xs:documentation>
SQL Server SOAP Session
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute
name="initiate"
default="false"
type="xs:boolean"
form="unqualified">
<xs:annotation>
<xs:documentation>
TRUE to request to start a new session
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute
name="terminate"
default="false"
type="xs:boolean"
form="unqualified">
<xs:annotation>
<xs:documentation>
TRUE to request to terminate an existing session
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="sessionId" type="xs:base64Binary" form="unqualified">
<xs:annotation>
<xs:documentation>
The ID of a session
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="timeout" type="xs:int" form="unqualified">
<xs:annotation>
<xs:documentation>
The timeout in seconds before the session expires.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute
name="transactionDescriptor"
type="xs:base64Binary"
form="unqualified">
<xs:annotation>
<xs:documentation>
The descriptor of a transaction to enlist to.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>