次の方法で共有


WS_CHANNEL_PROPERTY_ID列挙 (webservices.h)

各チャネル プロパティは ID で識別され、関連付けられた値を持ちます。 チャネルの作成時にプロパティが指定されていない場合は、既定値が使用されます。

構文

typedef enum {
  WS_CHANNEL_PROPERTY_MAX_BUFFERED_MESSAGE_SIZE = 0,
  WS_CHANNEL_PROPERTY_MAX_STREAMED_MESSAGE_SIZE = 1,
  WS_CHANNEL_PROPERTY_MAX_STREAMED_START_SIZE = 2,
  WS_CHANNEL_PROPERTY_MAX_STREAMED_FLUSH_SIZE = 3,
  WS_CHANNEL_PROPERTY_ENCODING = 4,
  WS_CHANNEL_PROPERTY_ENVELOPE_VERSION = 5,
  WS_CHANNEL_PROPERTY_ADDRESSING_VERSION = 6,
  WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE = 7,
  WS_CHANNEL_PROPERTY_STATE = 8,
  WS_CHANNEL_PROPERTY_ASYNC_CALLBACK_MODEL = 9,
  WS_CHANNEL_PROPERTY_IP_VERSION = 10,
  WS_CHANNEL_PROPERTY_RESOLVE_TIMEOUT = 11,
  WS_CHANNEL_PROPERTY_CONNECT_TIMEOUT = 12,
  WS_CHANNEL_PROPERTY_SEND_TIMEOUT = 13,
  WS_CHANNEL_PROPERTY_RECEIVE_RESPONSE_TIMEOUT = 14,
  WS_CHANNEL_PROPERTY_RECEIVE_TIMEOUT = 15,
  WS_CHANNEL_PROPERTY_CLOSE_TIMEOUT = 16,
  WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS = 17,
  WS_CHANNEL_PROPERTY_TRANSFER_MODE = 18,
  WS_CHANNEL_PROPERTY_MULTICAST_INTERFACE = 19,
  WS_CHANNEL_PROPERTY_MULTICAST_HOPS = 20,
  WS_CHANNEL_PROPERTY_REMOTE_ADDRESS = 21,
  WS_CHANNEL_PROPERTY_REMOTE_IP_ADDRESS = 22,
  WS_CHANNEL_PROPERTY_HTTP_CONNECTION_ID = 23,
  WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS = 24,
  WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS = 25,
  WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_INSTANCE = 26,
  WS_CHANNEL_PROPERTY_TRANSPORT_URL = 27,
  WS_CHANNEL_PROPERTY_NO_DELAY = 28,
  WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES = 29,
  WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME = 30,
  WS_CHANNEL_PROPERTY_KEEP_ALIVE_INTERVAL = 31,
  WS_CHANNEL_PROPERTY_MAX_HTTP_SERVER_CONNECTIONS = 32,
  WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN = 33,
  WS_CHANNEL_PROPERTY_CHANNEL_TYPE = 34,
  WS_CHANNEL_PROPERTY_TRIM_BUFFERED_MESSAGE_SIZE = 35,
  WS_CHANNEL_PROPERTY_ENCODER = 36,
  WS_CHANNEL_PROPERTY_DECODER = 37,
  WS_CHANNEL_PROPERTY_PROTECTION_LEVEL = 38,
  WS_CHANNEL_PROPERTY_COOKIE_MODE = 39,
  WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE = 40,
  WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY = 41,
  WS_CHANNEL_PROPERTY_HTTP_MESSAGE_MAPPING = 42,
  WS_CHANNEL_PROPERTY_ENABLE_HTTP_REDIRECT = 43,
  WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT = 44,
  WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS = 45,
  WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS = 46,
  WS_CHANNEL_PROPERTY_HTTP_SERVER_SPN = 47,
  WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN = 48,
  WS_CHANNEL_PROPERTY_MAX_HTTP_REQUEST_HEADERS_BUFFER_SIZE = 49
} WS_CHANNEL_PROPERTY_ID;

定数

 
WS_CHANNEL_PROPERTY_MAX_BUFFERED_MESSAGE_SIZE
値: 0
ULONG
WsCreateChannelWsCreateChannelForListener、または
wsGetChannelProperty for WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDINGまたはWS_NAMEDPIPE_CHANNEL_BINDING。 この値は、 の大きさに関する制限です。
メッセージは、チャネルによって受信または送信される可能性があります。 制限は最大サイズを指定します
エンコードされたワイヤ形式で表示される封筒のバイト単位。
最小値は 1 です。


このプロパティは、メモリの量を制限します
チャネルがバッファー内のメッセージを受信または送信するために割り当てる。
バッファー入力を使用してを受信すると、メッセージ全体が に読み取られます。
は、アプリケーションがアクセスする前にバッファーに格納されます。 バッファー出力で送信する場合は、次の処理を行います。
メッセージ全体がバッファーに蓄積されてから送信されます。


このプロパティは、バッファー内の入力または出力が行われた場合にのみ指定できます。
指定された ( WS_STREAMED_INPUT_TRANSFER_MODE または
WS_STREAMED_OUTPUT_TRANSFER_MODE が設定されていません)。


既定値は 65536 です。


WS_UDP_CHANNEL_BINDINGでは常に値 65536 が使用されます。
WS_CHANNEL_PROPERTY_MAX_STREAMED_MESSAGE_SIZE
値: 1
WsCreateChannel、WsCreateChannelForListener、または で使用される署名されていない__int64
WsGetChannelProperty
WS_HTTP_CHANNEL_BINDING。 This
value は、ストリーミング メッセージの受信または送信の大きさに関する制限です
チャネルの。
制限は、封筒の最大サイズをバイト単位で指定します。
そのエンコードされたワイヤ形式で。 最小値は 1 です。


このプロパティは、ストリーミングされた入力または出力が選択されている場合にのみ指定できます
(WS_STREAMED_INPUT_TRANSFER_MODE または WS_STREAMED_OUTPUT_TRANSFER_MODE が設定されています)。


既定値は 4194304 です。
WS_CHANNEL_PROPERTY_MAX_STREAMED_START_SIZE
値: 2
WsCreateChannel、WsCreateChannelForListener、または で使用される ULONG
wsGetChannelProperty for WS_HTTP_CHANNEL_BINDING
この値は、メッセージの開始の大きさに関する制限です。
メッセージの先頭は、封筒タグ、ヘッダー、本文タグで構成されます。
制限は、データの最大サイズをバイト単位で指定します。
そのエンコードされたワイヤフォーム。 最小値は 1 です。


このプロパティは、ストリーム入力が選択されている場合にのみ指定できます
(WS_STREAMED_INPUT_TRANSFER_MODE)。


このプロパティは、チャネルが割り当てるメモリの量を制限します
メッセージの先頭を読み取るために。 ストリーミング入力の場合、
メッセージの先頭全体が、アプリケーションの前にバッファーに読み込まれます
は、メッセージの開始が読み取られたことを通知します。


既定値は 16384 です。
WS_CHANNEL_PROPERTY_MAX_STREAMED_FLUSH_SIZE
値: 3
WsCreateChannel、WsCreateChannelForListener、または で使用される ULONG
wsGetChannelProperty for WS_HTTP_CHANNEL_BINDING
この値は、累積されるバイト数に関する制限です
WsFlushBody が呼び出される前に。


このプロパティは、ストリーミング出力が選択されている場合にのみ指定できます
(WS_STREAMED_OUTPUT_TRANSFER_MODE)。


このプロパティは、チャネルが割り当てるメモリの量を制限します
を使用して、バッファーに格納されたデータを蓄積します。 ストリーミング出力の場合、
チャネルは、 WsFlushBody が呼び出されるまでバッファーにデータを蓄積します。


既定値は 65536 です。
WS_CHANNEL_PROPERTY_ENCODING
値: 4
WS_ENCODING
WS_TCP_CHANNEL_BINDINGまたはWS_HTTP_CHANNEL_BINDINGWsCreateChannel、WsCreateChannelForListenerまたは WsGetChannelProperty で使用されます。
この値は、チャネルに使用するエンコーディングを指定します。


既定値は、バインドによって異なります。



WS_UDP_CHANNEL_BINDINGは常に値WS_ENCODING_XML_UTF8を使用します。
WS_CHANNEL_PROPERTY_ENVELOPE_VERSION
値: 5
WS_ENVELOPE_VERSION
WsCreateChannelWsCreateChannelForListener、または WsGetChannelProperty で使用されます。
この値は、チャネルに使用するエンベロープ バージョンを指定します。 次に、
チャネルのエンベロープ バージョンは、 で使用されるメッセージのバージョンと一致している必要があります
チャネル。


このプロパティは、 WS_NAMEDPIPE_CHANNEL_BINDINGではサポートされていません。 名前付きパイプ チャネルでは、常に WS_ENVELOPE_VERSION_SOAP_1_2が使用されます。

既定値は、バインドによって異なります。
WS_CHANNEL_PROPERTY_ADDRESSING_VERSION
値: 6
WS_ADDRESSING_VERSION
WsCreateChannelWsCreateChannelForListener、または WsGetChannelProperty で使用されます。
この値は、チャネルに使用するアドレス指定バージョンを指定します。 次に、
チャネルのアドレス指定バージョンは、 で使用されるメッセージのバージョンと一致している必要があります
チャネル。


既定値は、バインドによって異なります。



WS_ADDRESSING_VERSION_TRANSPORTは、 でのみサポートされています
WS_HTTP_CHANNEL_BINDING
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE
値: 7
WsCreateChannel、WsCreateChannelForListener、または WsGetChannelProperty で使用される ULONG
このプロパティは、 WS_TCP_CHANNEL_BINDING または WS_NAMEDPIPE_CHANNEL_BINDINGに対してのみ有効です。
この値は、セッション ディクショナリのバイト数のクォータを指定します
セッション ベースのエンコードを使用するときに送受信される文字列。


現在サポートされているセッション ベースのエンコードは、
WS_ENCODING_XML_BINARY_SESSION_1。これは既定のエンコードです
WS_TCP_CHANNEL_BINDING


クォータが受信側に達した場合、チャネル
エラーが発生します。


送信側でクォータに達した場合、チャネルは単に
セッション ディクショナリを使用せずに文字列を送信します。


セッション ベースのエンコードを使用しない場合、この値は無視されます。


既定値は 2048 です。
WS_CHANNEL_PROPERTY_STATE
値: 8
WS_CHANNEL_STATE
WsGetChannelProperty によって返されます。


戻り値は現在の状態のスナップショットであるため、
呼び出し元の前に状態が変更された可能性がある
値を調べる機会がありました。
WS_CHANNEL_PROPERTY_ASYNC_CALLBACK_MODEL
値: 9
WsCreateChannel または WsGetChannelProperty で使用されるWS_CALLBACK_MODEL値。
この値は、発行時に推奨される非同期コールバック モデルを示します
チャネルの非同期操作。


WsCreateChannelForListener を使用する場合は、次を参照してください。
WS_LISTENER_PROPERTY_ASYNC_CALLBACK_MODEL


既定値は WS_LONG_CALLBACK です。


WS_SERVICE_HOSTWS_SERVICE_PROXYの両方で、WS_LONG_CALLBACKのみがサポートされます
このプロパティの許容される値として。
WS_CHANNEL_PROPERTY_IP_VERSION
値: 10
WS_IP_VERSION
WS_TCP_CHANNEL_BINDINGまたはWS_UDP_CHANNEL_BINDINGWsCreateChannel または WsGetChannelProperty で使用されます。
このプロパティは、チャネルが使用する IP バージョンを指定します
リモート エンドポイントと通信します。


受け入れられるチャネルに使用する IP バージョンを指定するには、
WS_LISTENER_PROPERTY_IP_VERSION リスナー プロパティ
リスナー オブジェクトの作成。


既定値は WS_IP_VERSION_AUTO です。
WS_CHANNEL_PROPERTY_RESOLVE_TIMEOUT
値: 11
WsCreateChannelWsSetChannelProperty
WS_HTTP_CHANNEL_BINDINGとWS_CHANNEL_TYPE_REQUEST場合は WsSetChannelProperty
このタイムアウトにより、解決に費やす時間が制限されます
DNS 名。 タイムアウト値はミリ秒単位です。
値 INFINITE はタイムアウトを示しません。


このプロパティは、任意のチャネル状態で設定できます。


既定値は INFINITE です。
WS_CHANNEL_PROPERTY_CONNECT_TIMEOUT
値: 12
WsCreateChannel で使用される ULONG
WsSetChannelProperty、または WsGetChannelProperty
クライアント側 のWS_TCP_CHANNEL_BINDING または WS_NAMEDPIPE_CHANNEL_BINDING
このタイムアウトにより、リモート コンピューターへの接続と net.tcp または net.pipe ハンドシェイクの完了に費やす時間が制限されます。 タイムアウト値
はミリ秒単位で、値 INFINITE はタイムアウトがないことを示します。 設定するには
または、サーバー側で対応するタイムアウトを取得します。
(WS_LISTENER_PROPERTY_CONNECT_TIMEOUT)。


WsCreateChannel で使用されます。
WS_HTTP_CHANNEL_BINDINGWS_CHANNEL_TYPE_REQUEST場合は WsSetChannelProperty、または WsGetChannelProperty
このタイムアウトにより、接続に費やす時間が制限されます
を HTTP サーバーに送信します。 タイムアウト値はミリ秒単位です。
値 INFINITE はタイムアウトを示しません。


このプロパティは、任意のチャネル状態で設定できます。


既定値は 30000 (30 秒) です。


WS_SERVICE_PROXYでは、このタイムアウトが既定で INFINITE に設定されます。
WS_CHANNEL_PROPERTY_SEND_TIMEOUT
値: 13
WsCreateChannel、WsCreateChannelForListener で使用される ULONG
WsSetChannelProperty、または WsGetChannelProperty
WS_TCP_CHANNEL_BINDINGまたはWS_NAMEDPIPE_CHANNEL_BINDING。 このタイムアウトにより、
メッセージのバイトの送信に費やす時間。
タイムアウト値はミリ秒単位で、値 INFINITE は を示します。
タイムアウトなし。


WsCreateChannelWsSetChannelProperty
または wsGetChannelProperty for WS_HTTP_CHANNEL_BINDING
WS_CHANNEL_TYPE_REQUEST
このタイムアウトは、 の送信に費やす時間を制限します。
HTTP ヘッダーとメッセージのバイト数。 タイムアウト値はミリ秒単位です。ここで、
値 INFINITE はタイムアウトがないことを示します。


このプロパティは、任意のチャネル状態で設定できます。


既定値は 30000 (30 秒) です。


WS_SERVICE_HOSTWS_SERVICE_PROXYの両方でこれを設定します
タイムアウトを INFINITE に既定で設定します。
WS_CHANNEL_PROPERTY_RECEIVE_RESPONSE_TIMEOUT
値: 14
WsCreateChannelWsSetChannelProperty
WS_HTTP_CHANNEL_BINDINGとWS_CHANNEL_TYPE_REQUEST場合は WsSetChannelProperty
このタイムアウトは、待機に費やす時間を制限します
サーバーから受信するすべての応答ヘッダー。
タイムアウト値はミリ秒単位で、値 INFINITE はタイムアウトがないことを示します。


このプロパティは、任意のチャネル状態で設定できます。


既定値は 30000 (30 秒) です。


WS_SERVICE_PROXYは、このタイムアウトを INFINITE に設定します。
WS_CHANNEL_PROPERTY_RECEIVE_TIMEOUT
値: 15
WsCreateChannel、WsCreateChannelForListener で使用される ULONG
WsSetChannelProperty、または WsGetChannelProperty
WS_TCP_CHANNEL_BINDINGまたはWS_NAMEDPIPE_CHANNEL_BINDING
このタイムアウトは、 の受信に費やす時間を制限します。
メッセージのバイト数。
タイムアウト値はミリ秒単位で、値 INFINITE は を示します。
タイムアウトなし。


WsCreateChannelWsSetChannelProperty
WS_HTTP_CHANNEL_BINDINGとWS_CHANNEL_TYPE_REQUESTの場合WsGetChannelProperty
このタイムアウトは、 の受信に費やす時間を制限します。
メッセージのバイト数。 タイムアウト値はミリ秒単位です。
値 INFINITE はタイムアウトを示しません。
このタイムアウトは、 WsWriteMessageEndWsReadMessageStart、および WsReadMessageEnd によってトリガーできます。

このプロパティは、任意のチャネル状態で設定できます。


既定値は 30000 (30 秒) です。


WS_SERVICE_HOSTWS_SERVICE_PROXYの両方でこれを設定します
タイムアウトを INFINITE に既定で設定します。
WS_CHANNEL_PROPERTY_CLOSE_TIMEOUT
値: 16
WsCreateChannel、WsCreateChannelForListener で使用される ULONG
WsSetChannelProperty、または WsGetChannelProperty
WS_TCP_CHANNEL_BINDINGまたはWS_NAMEDPIPE_CHANNEL_BINDING
このタイムアウトは、 の完了に費やす時間を制限します。
閉じる net.tcp または net.pipe ハンドシェイク。 タイムアウト値はミリ秒単位です。ここで、
値 INFINITE はタイムアウトがないことを示します。


このプロパティは、任意のチャネル状態で設定できます。


既定値は 30000 (30 秒) です。


WS_SERVICE_PROXYでは、このタイムアウトが既定で INFINITE に設定されます。
WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS
値: 17
wsCreateChannel for WS_HTTP_CHANNEL_BINDING、WS_TCP_CHANNEL_BINDINGWS_NAMEDPIPE_CHANNEL_BINDING
WS_UDP_CHANNEL_BINDING
wsGetChannelProperty for WS_CUSTOM_CHANNEL_BINDINGで使用されます。


このプロパティが TRUE に設定されているか、 WsCreateChannel を呼び出すときに指定されていない場合は、
より具体的なチャネル タイムアウト プロパティ ( 例: WS_CHANNEL_PROPERTY_SEND_TIMEOUT)
が優先され、文書化されているとおりに動作します。 このプロパティが FALSE に設定されている場合、
明示的に指定されていない限り、すべての特定のチャネル タイムアウト プロパティは INFINITE に設定されます。


このプロパティは、 WsGetChannelProperty を使用してカスタム チャネルからクエリを実行できます。
詳細については 、「WS_GET_CHANNEL_PROPERTY_CALLBACK 」を参照してください。


既定値は TRUE です。


独自のタイムアウト ロジックを実装するには、 と をWS_SERVICE_PROXY します。
WS_SERVICE_HOST では、このプロパティを FALSE に設定します。
標準チャネルのバインドとカスタム チャネルを必要とします。
FALSE に設定されていることを確認 します
前述のように、より具体的なタイムアウト プロパティを引き続き指定できます。
WS_CHANNEL_PROPERTY_TRANSFER_MODE
値: 18
WS_TRANSFER_MODE
WsCreateChannel で使用される
メッセージを制御するためのWS_HTTP_CHANNEL_BINDING
チャネルで送受信されるは、バッファーまたはストリーミングされます。 クライアント
と サーバーは異なる転送モードを使用し、引き続き通信できます。


すべてのチャネルで、この WsGetChannelProperty が サポートされます
プロパティに基づきます)。


WS_HTTP_CHANNEL_BINDING以外のチャネル バインドの場合、値は常にWS_BUFFERED_TRANSFER_MODEされます。


既定のプロパティ値は WS_BUFFERED_TRANSFER_MODEです。 メモ
サービス モデルでは 、両方の WS_BUFFERED_TRANSFER_MODEのみが使用されます
WS_SERVICE_PROXYWS_SERVICE_HOST。 唯一の例外
は、WS_SERVICE_HOSTでのメッセージ コントラクトの使用に関するページです。
WS_STREAMED_OUTPUT_TRANSFER_MODE は許可されます。



WS_CHANNEL_TYPE_REQUEST使用するWS_STREAMED_OUTPUT_TRANSFER_MODE には Windows Vista 以上が必要であり、セキュリティで使用する場合は WS_HTTP_HEADER_AUTH_SCHEME_BASIC のみがサポートされます。
WS_CHANNEL_PROPERTY_MULTICAST_INTERFACE
値: 19
WsCreateChannelWsSetChannelProperty
または wsGetChannelProperty for WS_UDP_CHANNEL_BINDING
WS_CHANNEL_TYPE_DUPLEXを使用して、どのアダプターを指定します。
は、マルチキャスト アドレスへの送信時に使用する必要があります。


値は、アダプターのインターフェイス インデックスです。


このプロパティが設定されていない場合、または 0 の場合は、 の既定のアダプター
マシンが使用されます。 これは、複数のアダプターを持つマシンには適していない場合があります。


このプロパティは、任意のチャネル状態で設定できます。


既定のプロパティ値は 0 です。
WS_CHANNEL_PROPERTY_MULTICAST_HOPS
値: 20
WsCreateChannel または WsGetChannelProperty で使用される ULONG
WS_CHANNEL_TYPE_DUPLEXを使用したWS_UDP_CHANNEL_BINDING場合
UDP メッセージが移動できるホップの最大数を指定します。


既定のプロパティ値は 1 です。
WS_CHANNEL_PROPERTY_REMOTE_ADDRESS
値: 21
WS_ENDPOINT_ADDRESS構造体
WsGetChannelProperty で使用される
WS_CHANNEL_TYPE_DUPLEXを使用したWS_UDP_CHANNEL_BINDING場合
チャネルのリモート パーティのエンドポイント アドレスを取得します。


返される のフィールド
WS_ENDPOINT_ADDRESS 構造体は、チャネルまで有効で一定です
がリセットまたは解放されます。 呼び出し元は、返される値を変更しないでください
をポイントする WS_ENDPOINT_ADDRESS のフィールド。


チャネルが開いている状態に達するまで、このプロパティを取得できません。


このプロパティは、 から受信した送信元 IP アドレスに基づいています
ネットワークを使用している場合でも、スプーフィングまたは改ざんされる可能性があります。
セキュリティで保護されたチャネル (ネットワーク環境に応じて)。
WS_CHANNEL_PROPERTY_REMOTE_IP_ADDRESS
値: 22
SOCKADDR_STORAGE構造体
WsCreateChannel で使用
IP アドレスを取得する次の種類のチャネルの場合
リモート パーティの:



このプロパティは、チャネルがメッセージの読み取りを開始するまで取得できません。


このプロパティは、 から受信した送信元 IP アドレスに基づいています
ネットワークを使用している場合でも、スプーフィングされたり改ざんされたりする可能性があります。
セキュリティで保護されたチャネル (ネットワーク環境に応じて)。
WS_CHANNEL_PROPERTY_HTTP_CONNECTION_ID
値: 23
WsGetChannelProperty で使用される ULONGLONG へのポインター
WS_CHANNEL_TYPE_REPLYを使用したWS_HTTP_CHANNEL_BINDINGの場合
クライアント接続を一意に識別する識別子を取得する場合は 。


このプロパティは、チャネルがメッセージの読み取りを開始するまで取得できません。


接続 ID は、接続を一意に識別します。
チャネルが受け入れられたリスナー オブジェクトは開いたままです。


特定の応答チャネル インスタンスが接続と関連付けられる方法はありません。
チャネルが受け入れられるたびに、異なる接続 ID が存在する可能性があります
(最後の受け入れ以降に接続の合計セットが変更されていない場合でも)。


接続 ID は、アプリケーションで状態を関連付けるために使用できます
HTTP 接続。
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
値: 24
WS_CUSTOM_CHANNEL_BINDINGWsCreateChannel または WsCreateChannelForListener で使用されるWS_CUSTOM_CHANNEL_CALLBACKS構造体。


このプロパティは、次のコールバックを指定するために使用されます。
カスタム チャネルの実装を定義します。


このプロパティは、 WS_CUSTOM_CHANNEL_BINDING を使用する場合に指定する必要があります。
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
値: 25
WS_CUSTOM_CHANNEL_BINDINGWsCreateChannel または WsCreateChannelForListener使用される任意のサイズのデータ型へのポインター。


このプロパティは、カスタム の作成に使用されるパラメーターを指定するために使用されます。
チャネルの実装。


プロパティのサイズは、データ型のサイズです。


このプロパティの値は、 に渡されます。
WS_CREATE_CHANNEL_CALLBACK


このプロパティが指定されていない場合、その値は NULL で、size は 0 です。
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_INSTANCE
値: 26
WS_CUSTOM_CHANNEL_BINDINGWsGetChannelProperty で使用される void


プロパティのサイズは sizeof(void
)です
値は、 によって返されるチャネル インスタンスの値に対応します
WS_CREATE_CHANNEL_CALLBACK


このプロパティは、基になるチャネルを取得するために使用できます
カスタム チャネルの インスタンス。 これにより、呼び出し元は
既存のインスタンスが存在する場合にインスタンスとやり取りする
チャネル プロパティまたはチャネル関数のセットが不十分です。
WS_CHANNEL_PROPERTY_TRANSPORT_URL
値: 27
WS_STRING構造体
WsGetChannelProperty で使用
WsCreateChannelForListener で作成されたチャネルのWS_HTTP_CHANNEL_BINDINGまたはWS_TCP_CHANNEL_BINDING


このプロパティは、渡された URL を取得するためにサーバーで使用されます
をクライアント上 の WsOpenChannel に送信します。
この URL は、WS_TO_HEADERの値とは異なる場合があります
WsAddressMessage が使用された場合は 。 のマッピング
基になるトランスポートへのトランスポート URL は、
のように、WS_CHANNEL_BINDINGします。



このプロパティは、チャネルが
WsAcceptChannel を使用して受け入れられます。


呼び出し元は、次の場合に WS_STRING のアドレスを渡す必要があります
このプロパティを取得しています。 返される文字列は完全修飾です
エンコードされた形式の URL。 返される文字列は、チャネルまで適切です
は解放またはリセットされます。
WS_CHANNEL_PROPERTY_NO_DELAY
値: 28
WS_TCP_CHANNEL_BINDINGの WsCreateChannelWsCreateChannelForListenerWsGetChannelPropertyまたは WsSetChannelProperty で使用される BOOL


このプロパティは、基になるソケットのTCP_NODELAY ソケット オプション値を制御します。


この値が FALSE の場合、Nagle アルゴリズムが使用されます。このアルゴリズムは、次の操作を実行できます。
小さなメッセージを結合してスループットを向上させます。


この値を TRUE に設定すると、スループットを犠牲にして待機時間が短縮される可能性があります
小さなメッセージの場合は 。


既定値は FALSE です。
WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES
値: 29
wsCreateChannel、WS_TCP_CHANNEL_BINDINGWsCreateChannelForListener で使用される BOOL


このプロパティは、基になるソケットのSO_KEEPALIVE ソケット オプション値を制御します。


この値を TRUE に設定すると、キープアライブ パケットが送信されます
を基になるソケットに置き込みます。これは、次の場合に検出するのに役立ちます。
リモート パーティは使用できなくなりました。


既定値は FALSE です。
WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME
値: 30
WS_TCP_CHANNEL_BINDINGWsCreateChannel または WsCreateChannelForListener で使用される ULONG


このプロパティはミリ秒単位で測定されます。


このプロパティは、 WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES プロパティの値が TRUE の場合にのみ指定できます。


値は、キープアライブ パケットを送信するまでの時間を表します。
ソケットが使用されていません。


既定値は 2 時間です。
WS_CHANNEL_PROPERTY_KEEP_ALIVE_INTERVAL
値: 31
WS_TCP_CHANNEL_BINDINGWsCreateChannel または WsCreateChannelForListener で使用される ULONG


このプロパティはミリ秒単位で測定されます。


このプロパティは、 WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES プロパティの値が TRUE の場合にのみ指定できます。


WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIMEで指定された時間の有効期限が切れた後、
システムは、接続を試みるためにキープアライブ パケットの送信を開始します
リモート パーティ。 この設定は、システムが送信する頻度を制御します
別のパケット (再試行として)。


既定値は 1 秒です。
WS_CHANNEL_PROPERTY_MAX_HTTP_SERVER_CONNECTIONS
値: 32
wsCreateChannel for WS_HTTP_CHANNEL_BINDINGで使用される ULONG


このプロパティは、クライアント アプリケーションが接続の最大数を指定します。
は、HTTP サーバーに対して を持つことができます。
接続はキャッシュされ、同じ HTTP サーバーにアクセスする同じプロセス内の他のコンポーネントによって再利用される場合があります。


既定値は INFINITE (制限なし) です。
WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN
値: 33
WS_TCP_CHANNEL_BINDINGWsGetChannelProperty で使用される BOOL
または WS_CHANNEL_TYPE_DUPLEX_SESSIONWS_NAMEDPIPE_CHANNEL_BINDING


このプロパティは、
WsShutdownSessionChannel
チャネルをシャットダウンするために使用されます。


チャネルは 、WS_CHANNEL_STATE_OPEN または
WS_CHANNEL_STATE_FAULTED 状態。
WS_CHANNEL_PROPERTY_CHANNEL_TYPE
値: 34
WS_CHANNEL_TYPE
すべてのチャネルの種類に 対して WsGetChannelProperty と共に使用されます
を使用してチャネルの種類を照会します。


チャネルは任意の WS_CHANNEL_STATEに含めることができます。
WS_CHANNEL_PROPERTY_TRIM_BUFFERED_MESSAGE_SIZE
値: 35
WsCreateChannel、WsCreateChannelForListener、または で使用される ULONG
WS_TCP_CHANNEL_BINDINGWsGetChannelProperty
メモリ割り当てを制御するためのWS_HTTP_CHANNEL_BINDING、またはWS_NAMEDPIPE_CHANNEL_BINDING
チャネル上のメッセージの特性。


このプロパティは、チャネルが保持するメモリの最大量を指定します
メッセージが リセットされた後の周囲。 すべての
チャネルに表示されるメッセージはすべてこのサイズより小さく、割り当て
メッセージをバッファリングする目的で最小化されます。


このプロパティは、バッファーされた入力または出力が行われた場合にのみ指定できます
指定された ( WS_STREAMED_INPUT_TRANSFER_MODE または
WS_STREAMED_OUTPUT_TRANSFER_MODE が設定されていません)。


既定値は 65536 です。


WS_UDP_CHANNEL_BINDINGでは常に値 65536 が使用されます。
WS_CHANNEL_PROPERTY_ENCODER
値: 36
WS_TCP_CHANNEL_BINDINGWsCreateChannel または WsCreateChannelForListener で使用されるWS_CHANNEL_ENCODER構造体。
WS_HTTP_CHANNEL_BINDING、またはメッセージのカスタム エンコードを提供する WS_NAMEDPIPE_CHANNEL_BINDING

このプロパティは 、WS_UDP_CHANNEL_BINDINGでは使用できません。
WS_CHANNEL_PROPERTY_DECODER
値: 37
WS_TCP_CHANNEL_BINDINGWsCreateChannel または WsCreateChannelForListener で使用されるWS_CHANNEL_DECODER構造体。
WS_HTTP_CHANNEL_BINDING、またはメッセージ カスタム デンコードを提供するWS_NAMEDPIPE_CHANNEL_BINDING。

このプロパティは 、WS_UDP_CHANNEL_BINDINGでは使用できません。
WS_CHANNEL_PROPERTY_PROTECTION_LEVEL
値: 38
任意のチャネルの種類に対して WsGetChannelProperty で使用されるWS_PROTECTION_LEVEL値。


このプロパティは、
チャネルによって提供されるセキュリティ保証。


このプロパティの値は、セキュリティ要件によって異なります
チャネルに対して要求されます。
WS_CHANNEL_PROPERTY_COOKIE_MODE
値: 39
HTTP Cookie の処理方法を制御するために、wsCreateChannelWS_HTTP_CHANNEL_BINDINGで使用されるWS_COOKIE_MODE値。


既定値は WS_AUTO_COOKIE_MODE です。
WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE
値: 40
チャネルの HTTP プロキシ設定を制御するために、wsCreateChannelWS_HTTP_CHANNEL_BINDINGで使用されるWS_HTTP_PROXY_SETTING_MODE値。


既定値は WS_HTTP_PROXY_SETTING_MODE_AUTO です。
WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY
値: 41
HTTP チャネルのカスタム カスタム設定を指定するために、 wsCreateChannelWS_HTTP_CHANNEL_BINDING で使用されるWS_CUSTOM_HTTP_PROXY構造体。 このプロパティは、次の操作を行う必要
WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODEが に設定されている場合に指定する
WS_HTTP_PROXY_SETTING_MODE_CUSTOM


既定値は NULL です。
WS_CHANNEL_PROPERTY_HTTP_MESSAGE_MAPPING
値: 42
WS_HTTP_CHANNEL_BINDINGWsCreateChannel または WsCreateChannelForListener で使用されるWS_HTTP_MESSAGE_MAPPING構造体。


このプロパティ値は、HTTP 要求または応答のマップ方法を制御します
メッセージ オブジェクト。 詳細については、「 WS_HTTP_MESSAGE_MAPPING 」を参照してください。


このプロパティの既定値は、次の WS_HTTP_MESSAGE_MAPPING 構造体です。



  • requestMappingOptions: 0

  • requestHeaderMappings: なし

  • responseMappingOptions: 0

  • responseHeaderMappings: none



WS_HTTP_MESSAGE_MAPPING フィールド requestMappingOptions と responseMappingOptions は 0 である必要があります
エンコードがチャネル プロパティ WS_CHANNEL_PROPERTY_ENCODINGを使用してWS_ENCODING_RAWに設定されている場合を除きます。
WS_CHANNEL_PROPERTY_ENABLE_HTTP_REDIRECT
値: 43
WS_CHANNEL_TYPE_REQUESTでWS_HTTP_CHANNEL_BINDINGするために WsCreateChannelで使用される BOOL


このプロパティ値は、HTTP 自動リダイレクトを有効にするかどうかを制御します。


この値を TRUE に設定すると、HTTP 自動リダイレクトが有効になります。


既定値は FALSE です。
WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT プロパティが指定されている場合は、
このプロパティは無視されます。
WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT
値: 44
WS_HTTP_REDIRECT_CALLBACK_CONTEXT構造体
WS_CHANNEL_TYPE_REQUESTでWS_HTTP_CHANNEL_BINDINGするために WsCreateChannelと共に使用されます。


このプロパティ値は、自動 HTTP リダイレクトをより細かく制御する必要がある場合に指定できます。


このプロパティを設定すると、指定されたコールバック ルーチンが元のエンドポイント URL で呼び出されます
メッセージが転送される新しい URL。 コールバックの戻り値を使用して、
リダイレクトを許可する必要があります。
WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS
値: 45
WsCreateChannelWsSetChannelProperty
クライアントWS_HTTP_CHANNEL_BINDINGとWS_CHANNEL_TYPE_REQUEST、またはWS_TCP_CHANNEL_BINDINGWS_NAMEDPIPE_CHANNEL_BINDING、WS_UDP_CHANNEL_BINDINGの場合は WsGetChannelPropertyまたはWsCreateServiceProxy


TRUE に設定すると、エラーの受信時にチャネル関数とサービス モデル関数からエラー コードが返されます。
このランタイムによってエラーが認識された場合は、対応するエラー コードが返されます。
それ以外の場合は 、WS_E_ENDPOINT_FAULT_RECEIVED が返されます。 ( 「Windows Web Services の戻り値」を参照してください)。 FALSE に設定すると、 WsReceiveMessage
WsRequestReply は、障害が受信されたときに WS_E_ENDPOINT_FAULT_RECEIVED を返します。
他のチャネル関数は、エラーを通常のメッセージとして返し、'WS_MESSAGE_PROPERTY_IS_FAULT
は、エラーを他のメッセージと区別するために使用できます。


このプロパティが TRUE に設定され、 WsCreateChannel または WsSetChannelProperty で使用される場合、
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS の次の動作をオーバーライドします。障害が によって認識された場合は、
ランタイムでは、セキュリティで保護されていないエラーでは、エラー メッセージのセキュリティ検証は失敗しません
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS は FALSE に設定 されています。 セキュリティ検証の状態
は、 WS_MESSAGE_PROPERTY_PROTECTION_LEVELを調べることで決定できます。
これは、セキュリティをサポートしていないため 、WS_UDP_CHANNEL_BINDING には適用されません。


このプロパティが FALSE に設定されている場合、または WsCreateServiceProxy で使用されている場合、またはエラーが認識されない場合
ランタイムによって、 WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS で説明されている動作は、
例外です。


このプロパティ値に関係なく、エラーを受け取った結果としてエラー コードが返された場合は、
WsGetFaultErrorProperty を使用して、エラー オブジェクトからエラーの詳細を照会できます。


このプロパティは、任意のチャネル状態で設定できます。


既定値は TRUE です。 WsCreateServiceProxy と共に使用する場合は、このプロパティを TRUE に設定する必要があります。




このプロパティを TRUE に設定すると、特定のエラーに対してメッセージ セキュリティ検証が無効になる可能性があります。
未検証の障害は信頼できない可能性があります。
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS
値: 46
WsCreateChannelWsSetChannelProperty
または WsGetChannelProperty ( WS_HTTP_CHANNEL_BINDINGWS_CHANNEL_TYPE_REQUESTの場合)、またはクライアントで WS_TCP_CHANNEL_BINDINGWS_NAMEDPIPE_CHANNEL_BINDING


TRUE に設定すると、セキュリティで保護されたチャネルで受信されたセキュリティで保護されていないエラーによって、メッセージセキュリティ検証が失敗することはありません。 代わりに、
エラーは、メッセージセキュリティ検証が成功したかのように扱われ、 WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORSで説明されているように処理されます。
セキュリティ検証の状態は、 WS_MESSAGE_PROPERTY_PROTECTION_LEVELを調べることで判断できます。


FALSE に設定すると、エラー メッセージのメッセージ セキュリティ検証は、他のメッセージの検証と同様に処理されます。


WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS は、このランタイムによって認識されるエラーに対してこのプロパティをオーバーライドできます。


このプロパティは、メッセージ レベルのセキュリティ検証にのみ適用され、トランスポート セキュリティには影響しません。


このプロパティは、任意のチャネル状態で設定できます。


既定値は FALSE です。


このプロパティを TRUE に設定すると、エラーのメッセージ セキュリティ検証が無効になります。 セキュリティで保護されていない障害は信頼できない可能性があります。
WS_CHANNEL_PROPERTY_HTTP_SERVER_SPN
値: 47
WCHAR ポインター
WS_HTTP_CHANNEL_BINDINGWS_CHANNEL_TYPE_REQUESTWsGetChannelProperty と共に使用されます。



最後に失敗した要求に使用されたリモート エンドポイントのサーバー プリンシパル名を返します。 このプロパティが である保証はありません。
リリースします。 このプロパティが存在するために必要な (ただし必ずしも十分ではない) 条件を次に示します。

  • チャネルが要求を送信しました。

  • HTTP ヘッダー認証スキームの不一致が原因で要求が失敗しました。 「WS_HTTP_HEADER_AUTH_SECURITY_BINDING」を参照してください。

  • リモート エンドポイントでは、"Nego2" 認証スキームがサポートされています。




このプロパティは、Windows 7 以降でのみ使用できます。
WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN
値: 48
WS_HTTP_CHANNEL_BINDINGWS_CHANNEL_TYPE_REQUESTWsGetChannelProperty と共に使用される WCHAR ポインター。



最後に失敗した要求に使用された HTTP プロキシ サーバーのサーバー プリンシパル名を返します。 このプロパティが である保証はありません。
リリースします。 このプロパティが存在するために必要な (ただし必ずしも十分ではない) 条件を次に示します。

  • チャネルが要求を送信しました。

  • HTTP ヘッダー認証スキームの不一致が原因で要求が失敗しました。 「WS_HTTP_HEADER_AUTH_SECURITY_BINDING」を参照してください。

  • HTTP プロキシ サーバーでは、"Nego2" 認証スキームがサポートされています。




このプロパティは、Windows 7 以降でのみ使用できます。
WS_CHANNEL_PROPERTY_MAX_HTTP_REQUEST_HEADERS_BUFFER_SIZE
値: 49
WsCreateChannelForListener または で使用される ULONG
wsGetChannelProperty for WS_HTTP_CHANNEL_BINDING
WS_CHANNEL_TYPE_REPLY。 この値は、ヘッダーの大きい値に関する制限です
受け取る HTTP 要求の は である可能性があります。 制限は、最大サイズを指定します
HTTP 要求ヘッダーのバイト単位。


このプロパティは、メモリの量を制限します
WS_HTTP_CHANNEL_BINDINGWS_CHANNEL_TYPE_REPLY
は、HTTP 要求ヘッダーを受信するために を割り当てます。 を受信すると、HTTP 要求全体が
ヘッダーは、処理の前にバッファーに読み込まれます。


既定値は 65536 です。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
Header webservices.h