SOAP セッションの使用

[アーティクル]
12/16/2008

既存のセッションのコンテキスト内で SOAP 要求を実行するには、サーバーへの SOAP セッション要求の一部として次の項目を指定する必要があります。

以前にサーバーからクライアントに提供されたものと同じセッション ID。
以前に SOAP セッションが開始されたエンドポイントに対応する HTTP エンドポイント ID。
同じユーザーコンテキスト。これは、エンドポイントの SOAP プロパティでサポートされる LOGIN_TYPE に応じて、Windows ユーザーまたは SQL Server ユーザーのいずれかになります。

指定したセッション ID が存在しないか、形式が正しくない場合は、terminate 属性を含むヘッダーの sqlSession 要素により SOAP エラーメッセージが返されます。それ以外の場合は、サーバーはクライアントが要求で送信したものと同じ sqlSession ヘッダーをエコーバックすることにより応答します。

セッションを開始したセキュリティコンテキストやエンドポイントとは異なるもので要求が実行された場合、SOAP エラーが返されます。エラーの場合の応答では、SOAP 層終了の SOAP エラーコードが示され、sqlSession ヘッダーの terminate 属性には true 値が設定されます。

また、悪意のあるユーザーがセッションの存在を判断できないように、terminate 属性が設定され、サーバーにとって参加が不明であると特定されたセッション内のすべての要求に対する唯一の応答メッセージとして、サーバーから SOAP エラーが返されます。

例

次に、SOAP セッションに参加する例を示します。既存の SOAP セッションに参加することを要求するときに、クライアントから送信される SOAP メッセージの形式を示します。実際の sessionId 値は、セッション固有の識別子になります。

<SOAP-ENV:Header
  xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
  xmlns:sqloptions="https://schemas.microsoft.com/sqlserver/2004/SOAP/Options">
    <!-- enlist in an existing session -->
    <sqloptions:sqlSession sessionId="AAAAADreaLE="/>
</SOAP-ENV:Header>

サーバーでは、セッションにアクセスできることを示す場合はクライアントにメッセージをエコーバックします。また、要求で識別されたセッションにアクセスできないことを示す場合はクライアントに SOAP エラーを返します。

参照

次の方法で共有

SOAP セッションの使用

例

参照

関連項目

概念

その他の技術情報

ヘルプおよび情報

その他のリソース