다음을 통해 공유


WS_CHANNEL_PROPERTY_ID 열거형(webservices.h)

각 채널 속성은 ID로 식별되며 연결된 값을 가집니다. 채널을 만들 때 속성을 지정하지 않으면 기본값이 사용됩니다.

Syntax

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
WsCreateChannel, WsCreateChannelForListener 또는 와 함께 사용됨
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. 이번
값은 스트리밍된 메시지를 받거나 보낼 수 있는 크기로 제한됩니다.
채널에 대한 입니다.
제한은 봉투의 최대 크기를 바이트 단위로 지정합니다.
인코딩된 와이어 형식입니다. 최소값은 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
WsCreateChannel, WsCreateChannelForListener 또는 WsGetChannelProperty와 함께 사용됩니다.
이 값은 채널에 사용할 봉투 버전을 지정합니다. The
채널의 봉투 버전은 와 함께 사용되는 메시지의 버전과 일치해야 합니다.
채널입니다.


이 속성은 WS_NAMEDPIPE_CHANNEL_BINDING 지원되지 않습니다. 명명된 파이프 채널은 항상 WS_ENVELOPE_VERSION_SOAP_1_2 사용합니다.

기본값은 바인딩에 따라 달라집니다.
WS_CHANNEL_PROPERTY_ADDRESSING_VERSION
값: 6
WS_ADDRESSING_VERSION
WsCreateChannel, WsCreateChannelForListener 또는 WsGetChannelProperty와 함께 사용됩니다.
이 값은 채널에 사용할 주소 지정 버전을 지정합니다. The
채널의 주소 지정 버전은 와 함께 사용되는 메시지의 버전과 일치해야 합니다.
채널입니다.


기본값은 바인딩에 따라 달라집니다.



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
WsCreateChannel, WsSetChannelProperty와 함께 사용되는 ULONG
또는 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과 함께 사용됨,
WsSetChannelProperty 또는 WS_HTTP_CHANNEL_BINDING WS_CHANNEL_TYPE_REQUEST 대한 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 값은
시간 제한이 없습니다.


WsCreateChannel, WsSetChannelProperty와 함께 사용됨
또는 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
WsCreateChannel, WsSetChannelProperty와 함께 사용되는 ULONG
또는 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 값은
시간 제한이 없습니다.


WsCreateChannel, WsSetChannelProperty와 함께 사용됨
또는 WS_HTTP_CHANNEL_BINDING 및 WS_CHANNEL_TYPE_REQUEST 대한 WsGetChannelProperty입니다.
이 시간 제한은 를 받는 데 소요되는 시간을 제한합니다.
메시지의 바이트입니다. 시간 제한 값은 밀리초입니다.
여기서 INFINITE 값은 시간 제한을 나타내지 않습니다.
이 시간 제한은 WsWriteMessageEnd, WsReadMessageStartWsReadMessageEnd에 의해 트리거될 수 있습니다.

이 속성은 모든 채널 상태에서 설정할 수 있습니다.


기본값은 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
WS_HTTP_CHANNEL_BINDING,WS_TCP_CHANNEL_BINDING, WS_NAMEDPIPE_CHANNEL_BINDINGWsCreateChannel과 함께 사용되는 BOOL
WS_UDP_CHANNEL_BINDING.
WS_CUSTOM_CHANNEL_BINDING WsGetChannelProperty와 함께 사용됩니다.


이 속성이 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
WsCreateChannel, WsSetChannelProperty와 함께 사용되는 ULONG
또는 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는
채널이 허용된 수신기 개체는 열린 상태로 유지됩니다.


지정된 회신 채널 instance 연결과 아무런 상관 관계가 없습니다.
채널이 수락될 때마다 다른 연결 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_BINDING WsCreateChannel 또는 WsCreateChannelForListener와 함께 사용되는 임의의 크기의 데이터 형식에 대한 포인터입니다.


이 속성은 사용자 지정을 만드는 데 사용되는 매개 변수를 지정하는 데 사용됩니다.
채널 구현.


속성의 크기는 데이터 형식의 크기입니다.


이 속성의 값은 에 전달됩니다.
WS_CREATE_CHANNEL_CALLBACK.


이 속성을 지정하지 않으면 해당 값은 NULL 이고 크기는 0입니다.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_INSTANCE
값: 26
WS_CUSTOM_CHANNEL_BINDINGWsGetChannelProperty와 함께 사용되는 void 입니다.


속성의 크기는 sizeof(void
)입니다.
값은 에서 반환되는 채널 instance 값에 해당합니다.
WS_CREATE_CHANNEL_CALLBACK.


이 속성을 사용하여 기본 채널을 가져올 수 있습니다.
사용자 지정 채널에 대한 instance. 이렇게 하면 호출자가 직접 작업할 수 있습니다.
기존 사례에 대해 instance 상호 작용
채널 속성 또는 채널 함수 집합이 부족합니다.
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 WsCreateChannel, WsCreateChannelForListener 또는 WsGetChannelProperty 또는 WsSetChannelProperty와 함께 사용되는 BOOL입니다.


이 속성은 기본 소켓의 TCP_NODELAY 소켓 옵션 값을 제어합니다.


이 값이 FALSE이면 Nagle 알고리즘이 사용됩니다.
작은 메시지를 병합하여 처리량을 개선합니다.


이 값을 TRUE 로 설정하면 처리량의 비용으로 대기 시간이 감소할 수 있습니다.
작은 메시지의 경우


기본값은 FALSE입니다.
WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES
값: 29
WsCreateChannel, WsCreateChannelForListener와 함께 사용되는 BOOL은 WS_TCP_CHANNEL_BINDING.


이 속성은 기본 소켓의 SO_KEEPALIVE 소켓 옵션 값을 제어합니다.


이 값을 TRUE 로 설정하면 유지 패킷이 전송됩니다.
를 검색하는 데 도움이 될 수 있는 기본 소켓에서
원격 파티를 더 이상 사용할 수 없습니다.


기본값은 FALSE입니다.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME
값: 30
WS_TCP_CHANNEL_BINDING WsCreateChannel 또는 WsCreateChannelForListener와 함께 사용되는 ULONG입니다.


이 속성은 밀리초 단위로 측정됩니다.


이 속성은 WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES 속성 값이 TRUE인 경우에만 지정할 수 있습니다.


값은 에 있는 경우 활성 유지 패킷을 보내기 전의 시간을 나타냅니다.
소켓이 사용되지 않습니다.


기본값은 2시간입니다.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_INTERVAL
값: 31
WS_TCP_CHANNEL_BINDING WsCreateChannel 또는 WsCreateChannelForListener와 함께 사용되는 ULONG입니다.


이 속성은 밀리초 단위로 측정됩니다.


이 속성은 WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES 속성 값이 TRUE인 경우에만 지정할 수 있습니다.


WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME 지정된 시간이 만료된 후
시스템은 연결 시도에서 활성 유지 패킷을 보내기 시작합니다.
원격 파티입니다. 이 설정은 시스템이 보내는 빈도를 제어합니다.
다른 패킷(재시도 시도).


기본값은 1초입니다.
WS_CHANNEL_PROPERTY_MAX_HTTP_SERVER_CONNECTIONS
값: 32
WS_HTTP_CHANNEL_BINDINGWsCreateChannel과 함께 사용되는 ULONG입니다.


이 속성은 클라이언트 애플리케이션의 최대 연결 수를 지정합니다.
HTTP 서버에 대해 가 있을 수 있습니다.
동일한 HTTP 서버에 액세스하는 동일한 프로세스 내의 다른 구성 요소에서 연결을 캐시하고 다시 사용할 수 있습니다.


기본값은 INFINITE(제한 없음)입니다.
WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN
값: 33
WS_TCP_CHANNEL_BINDINGWsGetChannelProperty와 함께 사용되는 BOOL
또는 WS_CHANNEL_TYPE_DUPLEX_SESSION사용하여 WS_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
WsGetChannelProperty for WS_TCP_CHANNEL_BINDING
메모리 할당을 제어하는 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 쿠키 처리 방법을 제어하기 위해 WS_HTTP_CHANNEL_BINDINGWsCreateChannel 과 함께 사용되는 WS_COOKIE_MODE 값입니다.


기본값은 WS_AUTO_COOKIE_MODE.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE
값: 40
채널에 대한 HTTP 프록시 설정을 제어하기 위해 WS_HTTP_CHANNEL_BINDINGWsCreateChannel 과 함께 사용되는 WS_HTTP_PROXY_SETTING_MODE 값입니다.


기본값은 WS_HTTP_PROXY_SETTING_MODE_AUTO.
WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY
값: 41
HTTP 채널에 대한 사용자 지정 사용자 지정 설정을 지정하기 위해 WS_HTTP_CHANNEL_BINDING WsCreateChannel 과 함께 사용되는 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: none

  • 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
WsCreateChannel, WsSetChannelProperty와 함께 사용되는 BOOL
클라이언트에서 WS_HTTP_CHANNEL_BINDING 및 WS_CHANNEL_TYPE_REQUEST 또는 WS_TCP_CHANNEL_BINDING,WS_NAMEDPIPE_CHANNEL_BINDINGWS_UDP_CHANNEL_BINDINGWsGetChannelProperty 또는 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_FAULTSFALSE로 설정됩니다. 보안 확인의 상태
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
WsCreateChannel, WsSetChannelProperty와 함께 사용되는 BOOL,
또는 WS_HTTP_CHANNEL_BINDING 및 WS_CHANNEL_TYPE_REQUEST 대한 WsGetChannelProperty 또는 클라이언트에서 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_BINDING WS_CHANNEL_TYPE_REQUESTWsGetChannelProperty와 함께 사용됩니다.



마지막으로 실패한 요청에 사용된 원격 엔드포인트의 서버 보안 주체 이름을 반환합니다. 이 속성이
있습니다. 다음은 이 속성이 있는 데 필요한(항상 충분하지는 않음) 조건입니다.

  • 채널이 요청을 보냈습니다.

  • HTTP 헤더 인증 체계가 일치하지 않아 요청이 실패했습니다. WS_HTTP_HEADER_AUTH_SECURITY_BINDING 참조하세요.

  • 원격 엔드포인트는 "Nego2" 인증 체계를 지원합니다.




이 속성은 Windows 7 이상에서만 사용할 수 있습니다.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN
값: 48
WS_HTTP_CHANNEL_BINDING 및 WS_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 앱]
머리글 webservices.h