sqloptions:clientNetworkID (Header-Element)
Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird.
Die Anmeldeoption sqloptions:clientNetworkID ermöglicht es dem Client, die Clientnetzwerk-ID für die Anmeldung anzugeben, beispielsweise:
<SOAP-ENV:Header
xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:sqloptions="https://schemas.microsoft.com/sqlserver/2004/SOAP/Options">
<sqloptions:clientNetworkID SOAP-ENV:mustUnderstand="1" value="networkID" />
</SOAP-ENV:Header>
Die Anmeldeoption sqloptions:clientNetworkID erscheint als ein SOAP-Header. Er besteht aus einem Element, das den Namen sqloptions:clientNetworkID hat. Das Element verfügt über ein Attribut, value, einen im base64-Format codierten Binärwert. Dieses gibt die Clientnetzwerk-ID an, die für die Anmeldung festgelegt wird. Diese erscheint in der net_address-Spalte der Kompatibilitätssicht sys.sysprocesses.
In einer Anforderung kann nur eine Instanz der Option sqloptions:clientNetworkID erscheinen. Dieser Header kann nicht in einer Antwort erscheinen. Mehrere Instanzen der Option verursachen einen Fehler.
Der Server kann evtl. den Bereich der anerkannten Werte für den Wert sqloptions:clientNetwordID einschränken. Wenn ein Client einen Wert außerhalb des zulässigen Bereichs übermittelt, wird der Wert vom Server in einer nicht definierten Weise einfach abgeschnitten.
Wenn SOAP-Sitzungen verwendet werden, muss diese Option in derselben Anforderung erscheinen wie das Attribut sqloptions:sqlsession initiate. Wenn diese Option in irgendeiner Anforderung mit einem sqloptions:sqlSession-Header erscheint, der nicht auch ein initiate-Attribut enthält, wird ein Fehler erzeugt.
Das folgende Schemenfragment gilt für die sqloptions:clientNetworkID-Option:
<xs:element name="clientNetworkID" form="qualified">
<xs:annotation>
<xs:documentation>
Set the client network ID for the login.
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute
use="required"
name="value"
type="xs:base64Binary"
form="unqualified">
<xs:annotation>
<xs:documentation>
The client network ID to set for the login.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
Beispiele
Die folgenden Beispiele zeigen die Verwendung des sqloptions:clientNetworkID-Headers innerhalb von SOAP-Anforderungs- und -Antwortmeldungen.
Anforderung
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:sql="https://schemas.microsoft.com/sqlserver/2004/SOAP"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sqlparam="https://schemas.microsoft.com/sqlserver/2004/SOAP/types/SqlParameter"
xmlns:sqlsoaptypes="https://schemas.microsoft.com/sqlserver/2004/SOAP/types"
xmlns:sqloptions="https://schemas.microsoft.com/sqlserver/2004/SOAP/Options">
<SOAP-ENV:Header>
<sqloptions:clientNetworkID SOAP-ENV:mustUnderstand="1" value="AAAAADreaLE=" />
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<sql:sqlbatch>
<sql:BatchCommands>
SELECT TOP 1 net_address FROM sysprocesses WHERE spid=@@spid
</sql:BatchCommands>
</sql:sqlbatch>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Antwort
<SOAP-ENV:Envelope xml:space="preserve"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:sql="https://schemas.microsoft.com/sqlserver/2004/SOAP"
xmlns:sqlsoaptypes="https://schemas.microsoft.com/sqlserver/2004/SOAP/types"
xmlns:sqlrowcount="https://schemas.microsoft.com/sqlserver/2004/SOAP/types/SqlRowCount"
xmlns:sqlmessage="https://schemas.microsoft.com/sqlserver/2004/SOAP/types/SqlMessage"
xmlns:sqlresultstream="https://schemas.microsoft.com/sqlserver/2004/SOAP/types/SqlResultStream"
xmlns:sqltransaction="https://schemas.microsoft.com/sqlserver/2004/SOAP/types/SqlTransaction"
xmlns:sqltypes="https://schemas.microsoft.com/sqlserver/2004/sqltypes">
<SOAP-ENV:Body>
<sql:sqlbatchResponse>
<sql:sqlbatchResult>
<sqlresultstream:SqlRowSet xsi:type="sqlsoaptypes:SqlRowSet">
<diffgr:diffgram xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<SqlRowSet1 xmlns="urn:schemas-microsoft-com:sql:SqlRowSet1">
<row>
<net_address>value specified in the request</net_address>
</row>
</SqlRowSet1>
</diffgr:diffgram>
</sqlresultstream:SqlRowSet>
<sqlresultstream:SqlRowCount xsi:type="sqlrowcount:SqlRowCount">
<sqlrowcount:Count>1</sqlrowcount:Count>
</sqlresultstream:SqlRowCount>
</sql:sqlbatchResult>
</sql:sqlbatchResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>