Share via


SOAP-Erweiterungsheader

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.

Ab SQL Server 2005 kann eine Anforderung, die über HTTP und SOAP an eine Instanz von SQL Server gesendet wird, optionale Header enthalten, mit denen die Ausführungsweise der Anforderung geändert wird. Entsprechend kann die Instanz von SQL Server manchmal zusätzliche SOAP-Headerinformationen für spezifische Aktivitäten wie Datenbankspiegelung zurückgeben. Es folgt eine Übersicht der optionalen Header:

  • Optionale SQL-Header

  • Der WS-Security-Header (Web Services Security)

Optionale SQL-Header

Diese optionalen Header für SQL Server wurden in erster Linie zur HTTP-SOAP-Unterstützung hinzugefügt, um die Parität mit Optionen zu erreichen, die beim traditionellen SQL-Datenzugriff über Netzwerkverbindungen verfügbar sind, bei denen das TDS-Protokoll (Tabular Data Stream) verwendet wird.

Sofern nicht in diesem Abschnitt anders angegeben verwenden alle diese optionalen Header den Namespace-URI von "https://schemas.microsoft.com/sqlserver/2004/SOAP/Options", und ihnen ist das Namespacepräfix sqloptions zugeordnet, das in folgender Weise für jeden Header deklariert wird:

xmlns:sqloptions="https://schemas.microsoft.com/sqlserver/2004/SOAP/Options"

Die folgende Tabelle zeigt alle optionalen SQL-Header, die in SOAP-Anforderungsnachrichten unter SQL Server verwendet werden können.

Header

Beschreibung

sqloptions:applicationName (Header-Element)

Ermöglicht dem Client, den zu verwendenden Anwendungsnamen anzugeben.

sqloptions:clientInterface (Header-Element)

Ermöglicht dem Client, die zu verwendende Clientschnittstelle anzugeben.

sqloptions:clientNetworkID (Header-Element)

Ermöglicht dem Client, die bei der SQL-Anmeldung zu verwendende Clientnetzwerk-ID anzugeben.

sqloptions:clientPID (Header-Element)

Ermöglicht dem Client, die zu verwendende Clientprozess-ID anzugeben.

sqloptions:databaseMirroringPartner (Header-Element)

Wird vom Server zur Rückgabe von Informationen an einen Datenbankspiegelungspartner verwendet.

sqloptions:environmentChangeNotifications (Header-Element)

Ermöglicht dem Client anzugeben, welche Benachrichtigungen bei Umgebungsänderungen er vom Server empfangen möchte.

sqloptions:hostname (Header-Element)

Ermöglicht dem Client, den zu verwendenden Hostnamen anzugeben.

sqloptions:initialDatabase (Header-Element)

Ermöglicht dem Client, die zu verwendende erste Datenbank anzugeben.

sqloptions:initialLanguage (Header-Element)

Ermöglicht dem Client, die zu verwendende erste Sprache anzugeben.

sqloptions:notificatonRequest (Header-Element)

Ermöglicht dem Client das Anfordern einer Benachrichtigung vom Server.

sqloptions:sqlSession (Header Element)

Ermöglicht dem Client das Anfordern einer SOAP-Sitzung.

Der WS-Security-Header

Der Web Services Security-Header kann in SQL Server verwendet werden, um die Benutzernamen- und Kennwortanmeldeinformationen zur SQL Server-Authentifizierung anzugeben. Weitere Informationen zum WS-Security-Header und zu seiner Verwendung in SQL Server finden Sie unter SQL Server-Authentifizierung über SOAP.

WS-Security basiert auf einem offenen Standard, der bei der OASIS (Organization for the Advancement of Structured Information Standards) eingereicht wurde. Weitere Informationen zur Struktur des WS-Security-Standards finden Sie auf der OASIS-Website unter http://www.oasis-open.org.