다음을 통해 공유

WS_SERVICE_ENDPOINT_PROPERTY_ID 열거형(webservices.h)

  • 아티클

각 속성은 지정된 WS_SERVICE_ENDPOINT 구조를 구성하기 위한 선택적 매개 변수를 나타냅니다. 이 열거형은 WS_SERVICE_ENDPOINT 일부인 WS_SERVICE_ENDPOINT_PROPERTY 구조 내에서 사용됩니다.

Syntax

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
지정된 메시지 개체를 서비스하기 위해 풀링되는 호출 서비스 개체의 최대 수입니다.
끝점. 세션 기반 채널의 경우 단일에서 많은 호출 개체를 사용할 수 있습니다.
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_PATHWS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS.


이 속성을 설정 하는 경우 WS_METADATA_EXCHANGE_TYPE_HTTP_GET 애플리케이션 수신기에 대 한 WS_MATCH_URL_EXACT_PATH 지정 하지 않아야 합니다.
속성 은 지정된 WS_SERVICE_ENDPOINT 대한 WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS 및 WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA
값: 12
엔드포인트에 대한 WSDL 포트 이름, 바인딩 이름 및 바인딩 네임스페이스를 지정합니다.


WS-Metadata Exchange에서 WS_SERVICE_ENDPOINT 참여할 수 있도록 이 속성을 지정해야 합니다.


자세한 내용은 WS_SERVICE_ENDPOINT_METADATA 참조하세요.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX
값: 13
WS-MetadataExchange v1.1 요청 서비스에 대한 URL을 생성하기 위해 WS_SERVICE_ENDPOINT URL에 있는 그대로 연결된 접미사를 지정합니다.
생성된 URL은 받은 메시지의 'to' 헤더와 비교하는 데 사용됩니다. 메시지에 'to' 헤더가 포함되어 있지 않으면 요청이 포함되지 않습니다.
서비스.


이 속성은 WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE WS_METADATA_EXCHANGE_TYPE_MEX 설정된 경우에만 지정해야 합니다.


이 속성을 지정하면 애플리케이션이 WS-Transfer 요청을 처리하고 동일한 엔드포인트를 서비스에 사용하려는 경우에 유용합니다.
v1.1 요청을 WS-MetadataExchange. 이 경우 생성 URL은 Ws-MetadataExchange v1.1에 대한 요청 가져오기 WS-Transfer 필터링하는 데 사용됩니다.


기본적으로 MEX용 WS-MetadataExchange v1.1에 대해 필터링이 수행되지 않으며 모든 WS-Transfer GET 요청은 Ws-MetadataExchange v1.1에 대한 엔드포인트에서 처리됩니다.
Ws-MetadataExchange v1.1은 엔드포인트에서 사용하도록 설정됩니다.


이 속성은 및 WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS WS_LISTENER속성을 변경 합니다.
WS_MATCH_URL_PREFIX_PATHWS_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 [데스크톱 앱만 해당]
머리글 webservices.h