Partager via


En-têtes d'extension SOAP

Une demande envoyée à une instance de SQL Server 2005 à l'aide de HTTP et de SOAP peut contenir dans l'enveloppe SOAP des en-têtes facultatifs susceptibles de modifier l'exécution de la demande. De même, l'instance de SQL Server peut parfois renvoyer des informations d'en-tête SOAP supplémentaires sur des activités spécifiques. Les en-têtes facultatifs sont les suivants :

  • En-têtes SQL facultatifs
  • En-tête WS-Security (Web Services Security)

En-têtes SQL facultatifs

Ces en-têtes facultatifs de SQL Server 2005 ont été ajoutés à la prise en charge SOAP HTTP essentiellement à des fins de parité avec les options disponibles dans l'accès aux données SQL traditionnel via les connexions réseau utilisant le protocole TDS (Tabular Data Stream).

Sauf indication contraire dans cette section, chacun de ces en-têtes facultatifs utilise l'URI d'espace de noms « **https://schemas.microsoft.com/sqlserver/2004/SOAP/Options** » et est associé au préfixe d'espace de noms sqloptions déclaré de la façon suivante :

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

Le tableau ci-dessous répertorie tous les en-têtes SQL facultatifs utilisables dans la messagerie des demandes SOAP sous SQL Server 2005.

En-tête Description

Élément d'en-tête sqloptions:applicationName

Permet au client de spécifier un nom d'application à utiliser.

Élément d'en-tête sqloptions:clientInterface

Permet au client de spécifier une interface cliente à utiliser.

Élément d'en-tête sqloptions:clientNetworkID

Permet au client de spécifier un ID réseau client à utiliser dans la connexion SQL.

Élément d'en-tête sqloptions:clientPID

Permet au client de spécifier un ID de processus client à utiliser.

Élément d'en-tête sqloptions:databaseMirroringPartner

Permet au serveur de renvoyer des informations à un partenaire de mise en miroir de bases de données.

Élément d'en-tête sqloptions:environmentChangeNotifications

Permet au client de spécifier les notifications de modification d'environnement qu'il souhaite recevoir du serveur.

Élément d'en-tête sqloptions:hostname

Permet au client de spécifier un nom d'hôte à utiliser.

Élément d'en-tête sqloptions:initialDatabase

Permet au client de spécifier la base de données initiale à utiliser.

Élément d'en-tête sqloptions:initialLanguage

Permet au client de spécifier la langue initiale à utiliser.

Élément d'en-tête sqloptions:notificationRequest

Permet au client de demander une notification au serveur.

Élément d'en-tête sqloptions:sqlSession

Permet au client de demander une session SOAP.

En-tête WS-Security

L'en-tête WS-Security (Web Services Security) peut être utilisé avec SQL Server 2005 pour spécifier les informations d'identification relatives au nom et au mot de passe de l'utilisateur dans le cadre de l'authentification SQL Server. Pour plus d'informations sur la prise en charge de l'en-tête WS-Security dans SQL Server 2005, consultez Authentification SQL Server sur SOAP.

La technologie WS-Security est basée sur une norme ouverte qui a été soumise à l'OASIS (Organization for the Advancement of Structured Information Standards). Pour plus d'informations sur l'architecture standard de WS-Security, visitez le site Web d'OASIS à l'adresse http://www.oasis-open.org.

Voir aussi

Référence

Espaces de noms utilisés dans les demandes et les réponses SOAP
Structure des messages de demande SOAP
Ajout d'en-têtes SOAP à des applications clientes

Concepts

Méthodes préconisées pour l'utilisation des services Web XML natifs

Aide et Informations

Assistance sur SQL Server 2005