Share via

WS_SERVICE_ENDPOINT_PROPERTY_ID列挙 (webservices.h)

  • [アーティクル]

各プロパティは、指定された WS_SERVICE_ENDPOINT 構造を構成するための省略可能なパラメーターを表します。 この列挙体は、WS_SERVICE_ENDPOINTの一部である WS_SERVICE_ENDPOINT_PROPERTY 構造体内 で使用されます。

構文

typedef enum {
  WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK = 0,
  WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK = 1,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS = 2,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY = 3,
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE = 4,
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE = 5,
  WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES = 6,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE = 7,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE = 8,
  WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES = 9,
  WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND = 10,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE = 11,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA = 12,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX = 13,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS = 14
} WS_SERVICE_ENDPOINT_PROPERTY_ID;

定数

 
WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK
値: 0
WS_SERVICE_ENDPOINTで使用されます。
値は、構造体へのポインター WS_SERVICE_PROPERTY_ACCEPT_CALLBACK。
WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK
値: 1
WS_SERVICE_ENDPOINTで使用されます。
値は、構造体へのポインター WS_SERVICE_PROPERTY_CLOSE_CALLBACK。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS
値: 2
WS_SERVICE_ENDPOINTと共に使用されます。これは、サービス ホストが持つ同時実行チャネルの最大数を指定します
特定のエンドポイントの新しい接続をアクティブに受け入れます。 指定しない場合、この値は 1 に設定されます。 エンドポイントで既定のメッセージ ハンドラーが指定されている場合 ( 「WS_SERVICE_ENDPOINT」を参照) コンカレンシー
は 1 である必要があります。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY
値: 3
WS_SERVICE_ENDPOINTと共に使用されます。これは、セッション ベースのチャネルで処理される同時呼び出しの最大数を指定します。
指定しない場合、この値は 1 に設定されます。 エンドポイントで既定のメッセージ ハンドラーが指定されている場合 ( 「WS_SERVICE_ENDPOINT コンカレンシー」を参照してください)
は 1 である必要があります。
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE
値: 4
本文の逆シリアル化の最大 ヒープ サイズ。


これは、本文の逆シリアル化に使用されるヒープの設定です。 このヒープは、
パラメーターを割り当てるサービス操作で使用できます。


既定値は 65535 バイトです。
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE
値: 5
本文の逆シリアル化のヒープ トリミング サイズ。


これは、本文の逆シリアル化に使用されるヒープの設定です。 このヒープは、
パラメーターを割り当てるサービス操作で使用できます。


既定値は 4096 バイトです。
WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES
値: 6
このプロパティを使用すると、ユーザーはメッセージのプロパティを指定できます
メッセージの送受信にエンドポイントによって使用される オブジェクト。


このプロパティは、サービス ホストの作成時に指定できます。


指定する値は 、WS_MESSAGE_PROPERTIES型である必要があります。


次のメッセージ プロパティを指定できます。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE
値: 7
特定のメッセージ オブジェクトにサービスを提供するためにプールされる呼び出しサービス オブジェクトの最大数
エンドポイント。 セッション ベースのチャネルの場合、多くの呼び出しオブジェクトを 1 つのチャネルで使用できることに注意してください。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCYが 1 より大きい場合はチャネル。


セッションレス チャネルの場合、このプロパティは WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZEと等しいのが理想的です。


既定値は 100 です。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE
値: 8
特定の上のサービス ホストによってプールされる WS_CHANNEL の最大数
エンドポイント。


既定値は 100 です。
WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES
値: 9
リスナーのプロパティ。
WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND
値: 10
有効または無効にするには、エンドポイントでのヘッダー検証を理解する必要があります。 これは既定で 'TRUE' です。
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE
値: 11
このプロパティは、有効にするために WS_METADATA_EXCHANGE_TYPE_MEX に設定できます
エンドポイントでの WS-MetadataExchange 要求のサービス。 アプリケーションが希望する場合
HTTP GET を使用してメタデータを公開する場合、このプロパティを WS_METADATA_EXCHANGE_TYPE_HTTP_GET に設定できます

指定しない場合、このプロパティの既定値は 'WS_METADATA_EXCHANGE_TYPE_NONE' です。


このプロパティを WS_METADATA_EXCHANGE_TYPE_HTTP_GET に設定すると、WS_LISTENER プロパティが変更されることに注意してください
WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS と
WS_MATCH_URL_PREFIX_PATH に WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONSします。


このプロパティを WS_METADATA_EXCHANGE_TYPE_HTTP_GET に設定する場合、アプリケーションでリスナー のWS_MATCH_URL_EXACT_PATH を指定しないでください
プロパティ WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS し、指定 されたWS_SERVICE_ENDPOINT の WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONSします。
WS_SERVICE_ENDPOINT_PROPERTY_METADATA
値: 12
エンドポイントの WSDL ポート名、バインド名、およびバインド名前空間を指定 します。


exchange に WS_SERVICE_ENDPOINT を参加させるには、このプロパティ WS-Metadata 指定する必要があります。


詳細については、「 WS_SERVICE_ENDPOINT_METADATA 」を参照してください。
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX
値: 13
v1.1 要求サービスの URL を生成するために 、WS_SERVICE_ENDPOINT URL にそのまま連結 WS-MetadataExchange サフィックスを指定します。
生成された URL は、受信したメッセージの 'to' ヘッダーと比較するために使用されます。 メッセージに 'to' ヘッダーが含まれていない場合、要求は
サービス。


このプロパティは、 WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPEが WS_METADATA_EXCHANGE_TYPE_MEXに設定されている場合にのみ指定する必要があります。


このプロパティの指定は、アプリケーションが WS-Transfer Get 要求を処理し、サービスに対して同じエンドポイントを使用する場合に便利です
v1.1 要求を WS-MetadataExchange します。 この場合の生成 URL は、Ws-MetadataExchange v1.1 の get 要求 WS-Transfer 除外するために使用されます。


既定では、MEX の WS-MetadataExchange v1.1 に対してフィルター処理は行われず、WS-Transfer GET 要求はすべて、Ws-MetadataExchange v1.1 のエンドポイントによって処理されます。
エンドポイントで v1.1 が有効になっている Ws-MetadataExchange。


このプロパティは、 WS_LISTENER プロパティ WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS および
WS_MATCH_URL_PREFIX_PATH に WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONSします。


このプロパティを設定する場合、アプリケーションはリスナー のWS_MATCH_URL_EXACT_PATH を指定しないでください
プロパティ WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS と WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS
指定された WS_SERVICE_ENDPOINTに対して。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS
値: 14
エンドポイントで処理できるチャネルの最大数。


既定値は 100 です。

要件

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