Share via


SOAP-Erweiterungsheader

Eine mithilfe von HTTP und SOAP zu einer Instanz von SQL Server 2005 gesendete Anforderung kann im SOAP-Umschlag 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 spezielle Aktivitäten 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 2005 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 2005 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 WS-Security-Header (Web Services Security) kann in SQL Server 2005 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 2005 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.

Siehe auch

Verweis

In SOAP-Anforderungen und -Antworten verwendete Namespaces
Struktur der SOAP-Anforderungsnachricht
Hinzufügen von SOAP-Headern zu Clientanwendungen

Konzepte

Bewährte Methoden für das Verwenden systemeigener XML-Webdienste

Hilfe und Informationen

Informationsquellen für SQL Server 2005