sqloptions:sqlSession (elemento de encabezado)
Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.
La opción sqloptions:sqlSession permite al cliente controlar la sesión de la solicitud cuando se incluye y aparece como un encabezado SOAP.
El encabezado está compuesto por un elemento, denominado sqloptions:sqlSession. El elemento cuenta con cinco atributos opcionales: initiate, terminate, sessionId, timeout y transactionDescriptor. Para obtener más información sobre el uso y el comportamiento de los atributos individuales, vea Trabajar con sesiones SOAP.
Sólo puede aparecer una instancia de la opción sqloptions:sqlSession en una solicitud o en una respuesta. La presencia de varias instancias de la opción generará un error.
A continuación se muestra un fragmento de esquema correspondiente a la opción 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>