ITsSbClientConnection::P utContext メソッド (sbtsv.h)
プラグインは、接続に固有のコンテキスト情報を格納するために使用できます。
構文
HRESULT PutContext(
[in] BSTR contextId,
[in] VARIANT context,
[out, optional] VARIANT *existingContext
);
パラメーター
[in] contextId
コンテキスト ID を含む BSTR 変数。 プラグイン間の競合を回避するために、コンテキスト ID として一意識別子を使用することをお勧めします。クライアント接続オブジェクトは、複数のプラグインで使用できます。
[in] context
格納するコンテキスト情報。
[out, optional] existingContext
指定されたコンテキスト ID の既存のコンテキスト情報 (存在する場合) は、このパラメーターで返されます。 既存の情報が上書きされます。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
プラグインは、クライアント接続オブジェクトを使用して、接続要求に固有のコンテキスト情報を格納できます。 これにより、プラグインはステートレスを維持し、接続要求によって格納された状態情報のみに依存できます。 このメソッドを使用するプラグインは、接続要求通知に登録することもできます。 コンテキストは、CONNECTION_REQUEST_FAILED、CONNECTION_REQUEST_TIMEDOUT、またはCONNECTION_REQUEST_SUCCEEDED通知の受信時に削除できます。 これらの通知は、接続要求が削除されようとしていることを示します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | Windows |
| ヘッダー | sbtsv.h |