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_HOST 및 WS_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_HOST 및 WS_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, WsReadMessageStart 및 WsReadMessageEnd에 의해 트리거될 수 있습니다. 이 속성은 모든 채널 상태에서 설정할 수 있습니다. 기본값은 30000(30초)입니다. WS_SERVICE_HOST 및 WS_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_PROXY 및 WS_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 구조체입니다.
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_BINDING및WS_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_BINDING 및 WS_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와 함께 사용됩니다. 마지막으로 실패한 요청에 사용된 원격 엔드포인트의 서버 보안 주체 이름을 반환합니다. 이 속성이 있습니다. 다음은 이 속성이 있는 데 필요한(항상 충분하지는 않음) 조건입니다.
이 속성은 Windows 7 이상에서만 사용할 수 있습니다. |
WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN값: 48 WS_HTTP_CHANNEL_BINDING 및 WS_CHANNEL_TYPE_REQUESTWsGetChannelProperty와 함께 사용되는 WCHAR 포인터입니다. 마지막으로 실패한 요청에 사용된 HTTP 프록시 서버의 서버 보안 주체 이름을 반환합니다. 이 속성이 있습니다. 다음은 이 속성이 있는 데 필요한(항상 충분하지는 않음) 조건입니다.
이 속성은 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 |