WS_MESSAGE_PROPERTY_ID 열거형(webservices.h)

  • 아티클

각 메시지 속성은 WS_MESSAGE_PROPERTY 형식이고, ID로 식별되며, 연결된 값을 가집니다.

Syntax

typedef enum {
  WS_MESSAGE_PROPERTY_STATE = 0,
  WS_MESSAGE_PROPERTY_HEAP = 1,
  WS_MESSAGE_PROPERTY_ENVELOPE_VERSION = 2,
  WS_MESSAGE_PROPERTY_ADDRESSING_VERSION = 3,
  WS_MESSAGE_PROPERTY_HEADER_BUFFER = 4,
  WS_MESSAGE_PROPERTY_HEADER_POSITION = 5,
  WS_MESSAGE_PROPERTY_BODY_READER = 6,
  WS_MESSAGE_PROPERTY_BODY_WRITER = 7,
  WS_MESSAGE_PROPERTY_IS_ADDRESSED = 8,
  WS_MESSAGE_PROPERTY_HEAP_PROPERTIES = 9,
  WS_MESSAGE_PROPERTY_XML_READER_PROPERTIES = 10,
  WS_MESSAGE_PROPERTY_XML_WRITER_PROPERTIES = 11,
  WS_MESSAGE_PROPERTY_IS_FAULT = 12,
  WS_MESSAGE_PROPERTY_MAX_PROCESSED_HEADERS = 13,
  WS_MESSAGE_PROPERTY_USERNAME = 14,
  WS_MESSAGE_PROPERTY_ENCODED_CERT = 15,
  WS_MESSAGE_PROPERTY_TRANSPORT_SECURITY_WINDOWS_TOKEN = 16,
  WS_MESSAGE_PROPERTY_HTTP_HEADER_AUTH_WINDOWS_TOKEN = 17,
  WS_MESSAGE_PROPERTY_MESSAGE_SECURITY_WINDOWS_TOKEN = 18,
  WS_MESSAGE_PROPERTY_SAML_ASSERTION = 19,
  WS_MESSAGE_PROPERTY_SECURITY_CONTEXT = 20,
  WS_MESSAGE_PROPERTY_PROTECTION_LEVEL = 21
} WS_MESSAGE_PROPERTY_ID;

상수

 
WS_MESSAGE_PROPERTY_STATE
값: 0
이 속성은 WsGetMessageProperty와 함께 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 메시지의 현재 WS_MESSAGE_STATE.

이 속성은 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_PROPERTY_HEAP
값: 1
이 속성은 WsGetMessageProperty와 함께 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 메시지의 WS_HEAP. 힙은
메시지에서 소유합니다. 메시지 사용자는 추가 작업을 자유롭게 할 수 있습니다.
이 힙 내의 할당입니다. 힙 내의 할당이 해제됨
메시지가 다시 설정/해제되면 입니다.


반환된 힙의 사용자는 힙에서 WsResetHeap 을 호출하면 안 됩니다. 이렇게 하면 정의되지 않은 동작이 발생합니다.


메시지 개체는 중 하나가 아닌 한 힙 개체를 사용하지 않습니다.
메시지 API가 호출됩니다.


이 속성은 WS_MESSAGE_STATE_EMPTY 제외한 모든 메시지 상태에서 사용할 수 있습니다.
빈 메시지의 힙을 사용하면 정의되지 않은 동작이 발생합니다.
WS_MESSAGE_PROPERTY_ENVELOPE_VERSION
값: 2
이 속성은 WsGetMessageProperty와 함께 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 메시지의 WS_ENVELOPE_VERSION.


WsCreateMessage를 사용하여 메시지를 만들 때
봉투 버전은 명시적 매개 변수로 지정됩니다(대신).
을 속성으로 지정합니다.


이 속성은 를 사용하여 메시지 속성을 지정할 때 지정할 수 있습니다.
WS_MESSAGE_PROPERTIES 구조체입니다.


이 속성은 WS_MESSAGE_STATE_EMPTY 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_PROPERTY_ADDRESSING_VERSION
값: 3
이 속성은 WsGetMessageProperty와 함께 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 메시지의 WS_ADDRESSING_VERSION.


WsCreateMessage를 사용하여 메시지를 만들 때
addressing 버전은 명시적 매개 변수로 지정됩니다(대신).
을 속성으로 지정합니다.


이 속성은 를 사용하여 메시지 속성을 지정할 때 지정할 수 있습니다.
WS_MESSAGE_PROPERTIES 구조체입니다.


이 속성은 WS_MESSAGE_STATE_EMPTY 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_PROPERTY_HEADER_BUFFER
값: 4
이 속성은 WsGetMessageProperty와 함께 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 헤더를 보유하는 WS_XML_BUFFER
메시지(봉투 및 본문 요소)의 입니다.


이 버퍼는 메시지가 다시 설정/해제될 때까지 유효합니다.


이 속성은 WS_MESSAGE_STATE_EMPTY 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_PROPERTY_HEADER_POSITION
값: 5
이 속성은 WsGetMessageProperty와 함께 사용됩니다.

WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 헤더 버퍼 내의 헤더 요소(모두 포함된 요소)의 WS_XML_NODE_POSITION.
메시지 헤더를 자식으로). 헤더 버퍼 자체는
WS_MESSAGE_PROPERTY_HEADER_BUFFER 사용하여 가져옵니다.


애플리케이션은 시작으로 반환된 WS_XML_NODE_POSITION 사용할 수 있습니다.
헤더를 수동으로 읽거나 쓸 때의 지점( WsSetHeader를 사용하지 않는 경우,
WsGetHeader, WsGetCustomHeader 또는 WsAddCustomHeader).
예를 들어 위치는 WsSetWriterPosition 또는 에 전달될 수 있습니다.
WsSetReaderPosition - 헤더가 포함된 WS_XML_BUFFER 내에 XML 판독기 또는 XML 기록기를 배치합니다. 또한
WsMoveReader 또는 WsMoveWriter 를 사용하여 상대 이동
설정된 위치로 입니다.


메시지의 헤더를 읽는 경우( WsReadMessageStart 또는 를 통해)
WsReadEnvelopeStart, 헤더 요소는 자동으로 에 추가됩니다.
읽는 메시지에 헤더 버퍼가 없으면 버퍼입니다. 메시지가 초기화되는 경우
( WsInitializeMessage를 통해) 헤더 요소가 자동으로 추가됩니다.
메시지로 연결합니다.


이 속성은 WS_MESSAGE_STATE_EMPTY 제외한 모든 메시지 상태에서 사용할 수 있습니다.


헤더 위치는 메시지가 다시 설정되거나 해제될 때까지 유효합니다.
WS_MESSAGE_PROPERTY_BODY_READER
값: 6
이 속성은 WsGetMessageProperty와 함께 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 읽는 데 사용할 수 있는 WS_XML_READER
메시지의 본문입니다.


판독기는 메시지 개체가 소유하고 있으며 유효한 경우에만 유효합니다.
WsFreeMessage 또는 WsResetMessage가 호출될 때까지


이 속성은 메시지가 있는 경우에만 사용할 수 있습니다.
WS_MESSAGE_STATE_READING 상태입니다.
WS_MESSAGE_PROPERTY_BODY_WRITER
값: 7
이 속성은 WsGetMessageProperty와 함께 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 쓰기에 사용할 수 있는 WS_XML_WRITER
메시지의 본문입니다.


이 속성은 메시지가 있는 경우에만 사용할 수 있습니다.
WS_MESSAGE_STATE_WRITING 상태입니다.


기록기는 메시지 개체에 의해 소유되며 유효한 경우에만 유효합니다.
WsFreeMessage 또는 WsResetMessage가 호출될 때까지
WS_MESSAGE_PROPERTY_IS_ADDRESSED
값: 8
이 속성은 WsGetMessageProperty와 함께 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 메시지가 있는지 여부를 나타내는 BOOL입니다.
주소를 지정했습니다.


메시지가 만들어지거나 다시 설정되면 이 속성은 다음과 같습니다.
을 FALSE로 설정합니다.


메시지를 읽는 경우(WsReadMessageStart 또는
WsReadEnvelopeStart, 이 속성은
을 TRUE로 설정합니다.


이 속성은 WS_MESSAGE_STATE_EMPTY 제외한 모든 메시지 상태에서 사용할 수 있습니다.


자세한 내용은 WsAddressMessage 를 참조하세요.
WS_MESSAGE_PROPERTY_HEAP_PROPERTIES
값: 9
이 속성은 WsCreateMessage 와 함께 사용되어 속성을 지정합니다.
메시지와 연결된 WS_HEAP .


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 WS_HEAP_PROPERTIES 형식입니다.


힙은 메시지의 헤더를 버퍼링하는 데 사용됩니다.


다음 힙 속성을 지정할 수 있습니다.
WS_MESSAGE_PROPERTY_XML_READER_PROPERTIES
값: 10
이 속성은 WsCreateMessage 와 함께 사용되어 속성을 지정합니다.
메시지와 함께 사용되는 XML 판독 기에서 적용되는 입니다.


이러한 XML 판독기 속성은 헤더를 읽을 때 메시지 개체에서 사용됩니다.
또한 채널은 읽기 위해 만든 판독기에서 이러한 속성을 사용합니다.
메시지.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 WS_XML_READER_PROPERTIES 형식입니다.


다음 속성을 지정할 수 있습니다.
WS_MESSAGE_PROPERTY_XML_WRITER_PROPERTIES
값: 11
이 속성은 WsCreateMessage 와 함께 사용되어 속성을 지정합니다.
메시지와 함께 사용되는 XML 기록 기의 입니다.


이러한 XML 기록기 속성은 헤더를 작성할 때 메시지 개체에서 사용됩니다.
또한 채널은 작성하기 위해 만든 작성기에 이러한 속성을 사용합니다.
메시지.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 WS_XML_WRITER_PROPERTIES 형식입니다.


다음 속성을 지정할 수 있습니다.
WS_MESSAGE_PROPERTY_IS_FAULT
값: 12
이 속성은 메시지에 오류가 포함되어 있는지 여부를 나타내기 위해 WsGetMessageProperty 또는 WsSetMessageProperty 와 함께 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 BOOL입니다.

메시지를 읽을 때(WsReadMessageStart 또는 WsReadEnvelopeStart)
이 속성은 본문의 첫 번째 요소가 오류인지 여부에 따라 설정됩니다.
요소. 애플리케이션이 여부를 결정하는 방법으로 이 속성을 테스트할 수 있습니다.
을 사용하여 본문을 오류로 읽습니다. 본문을 오류로 읽으려면 WsReadBody를 사용합니다.
WS_FAULT_TYPE 사용하여 WS_FAULT 가져옵니다.


메시지가 기록되는 경우(WsWriteMessageStart 또는 WsWriteEnvelopeStart)
이 속성을 사용하여 애플리케이션에서 오류를 쓸지 여부를 나타낼 수 있습니다.
본문에 있습니다. 일부 채널은 이 정보를 사용하여 방법을 결정합니다.
메시지를 보냅니다. 예를 들어 HTTP는 200이 아닌 오류에 대해 500개의 상태 코드를 보냅니다.


와 함께 WsInitializeMessage를 사용하여 메시지를 초기화하는 경우
WS_FAULT_MESSAGE 속성이 TRUE로 설정됩니다.
다른 WS_MESSAGE_INITIALIZATION 값의 경우 속성은 FALSE로 설정됩니다.


이 속성은 WS_MESSAGE_STATE_EMPTY 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_PROPERTY_MAX_PROCESSED_HEADERS
값: 13
이 속성은 WsCreateMessage 와 함께 헤더의 최대 수를 지정하는 데 사용됩니다.
메시지 헤더를 처리할 때 허용되는 입니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 ULONG입니다.

이 제한의 목적은 반복 횟수에 상한을 두는 것입니다.
헤더를 검색하는 데 사용되었습니다.


애플리케이션은 헤더 버퍼의 내용을 직접 수정할 수 있으므로
이 제한은 모든 경우에 적용되지 않습니다. 다음 중 하나일 때만 적용됩니다.
헤더 액세스 API가 사용됩니다(WsSetHeader, WsGetHeader,
WsGetCustomHeader 또는 WsGetMappedHeader).


기본값은 64입니다.
WS_MESSAGE_PROPERTY_USERNAME
값: 14
이 속성은 WsGetMessageProperty 와 함께 발신자를 검색하는 데 사용됩니다.
받은 메시지의 사용자 이름(사용자 이름/암호 기반 보안인 경우)
가 켜지거나 사용자 지정 채널이 값을 설정한 경우 입니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 WS_STRING 구조체입니다.

반환된 값은 메시지가 해제되거나 다시 설정될 때까지 적합합니다.


사용자 지정 채널은 WsSetMessageProperty 를 사용하여 설정할 수 있습니다.
메시지에서 보낸 사람의 사용자 이름이 사용자 이름/암호를 지원하는 경우
보안 기반. 함수는 지정된 값의 복사본을 만듭니다.


이 속성은 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_STATE_EMPTY.
WS_MESSAGE_PROPERTY_ENCODED_CERT
값: 15
이 속성은 WsGetMessageProperty 와 함께 발신자를 검색하는 데 사용됩니다.
받은 메시지의 인증서를 인코딩된 바이트로, 인코딩된 경우
인증서 기반 보안 모드(예: SSL)가 켜짐
또는 사용자 지정 채널이 값을 설정한 경우 입니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 WS_BYTES 구조체입니다.

반환된 값은 메시지가 해제되거나 다시 설정될 때까지 적합합니다.


사용자 지정 채널은 WsSetMessageProperty 를 사용하여 설정할 수 있습니다.
보낸 사람의 인증서가 지원되는 경우 받은 메시지의 인증서
인증서 기반 보안 모드입니다. 함수는 지정된 값의 복사본을 만듭니다.


이 속성은 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_STATE_EMPTY.
WS_MESSAGE_PROPERTY_TRANSPORT_SECURITY_WINDOWS_TOKEN
값: 16
이 속성은 WsGetMessageProperty 와 함께 Windows를 검색하는 데 사용됩니다.
받은 메시지의 보낸 사람 을 나타내는 토큰입니다. 이 속성은
다음 경우에 사용할 수 있습니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 HANDLE입니다.


반환된 값은 메시지가 해제되거나 다시 설정될 때까지 적합합니다.


사용자 지정 채널은 WsSetMessageProperty 를 사용하여 설정할 수 있습니다.
보낸 사람의 인증서가 지원되는 경우 받은 메시지의 인증서
인증서 기반 보안 모드입니다. 함수는 지정된 핸들을 복제합니다.


이 속성은 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_STATE_EMPTY.
WS_MESSAGE_PROPERTY_HTTP_HEADER_AUTH_WINDOWS_TOKEN
값: 17
이 속성은 WsGetMessageProperty 와 함께 Windows를 검색하는 데 사용됩니다.
받은 메시지의 보낸 사람(있는 경우)을 나타내는 토큰
WS_HTTP_HEADER_AUTH_SECURITY_BINDING 사용됩니다.
또는 사용자 지정 채널이 값을 설정한 경우 입니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 HANDLE입니다.

반환된 값은 메시지가 해제되거나 다시 설정될 때까지 적합합니다.


사용자 지정 채널은 WsSetMessageProperty 를 사용하여 설정할 수 있습니다.
받은 메시지의 보낸 사람 을 나타내는 창 토큰입니다.
함수는 지정된 핸들을 복제합니다.


이 속성은 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_STATE_EMPTY.
WS_MESSAGE_PROPERTY_MESSAGE_SECURITY_WINDOWS_TOKEN
값: 18
이 속성은 WsGetMessageProperty 와 함께 Windows를 검색하는 데 사용됩니다.
받은 메시지의 보낸 사람(메시지 보안인 경우)을 나타내는 토큰
WS_KERBEROS_APREQ_MESSAGE_SECURITY_BINDING 같은 바인딩이 사용됩니다.
또는 사용자 지정 채널이 값을 설정한 경우 입니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 HANDLE입니다.

반환된 값은 메시지가 해제되거나 다시 설정될 때까지 적합합니다.


사용자 지정 채널은 WsSetMessageProperty 를 사용하여 설정할 수 있습니다.
받은 메시지의 보낸 사람 을 나타내는 토큰입니다.
함수는 지정된 핸들을 복제합니다.


이 속성은 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_STATE_EMPTY.
WS_MESSAGE_PROPERTY_SAML_ASSERTION
값: 19
이 속성은 WsGetMessageProperty 와 함께 SAML 어설션을 검색하는 데 사용됩니다.
수신된 메시지에서 보낸 사람(있는 경우)을 나타냅니다.
WS_SAML_MESSAGE_SECURITY_BINDING 서버 쪽에서 사용됩니다.
또는 사용자 지정 채널이 값을 설정한 경우 입니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 WS_XML_BUFFER.

반환된 값은 메시지가 해제되거나 다시 설정될 때까지 적합합니다.


사용자 지정 채널은 WsSetMessageProperty 를 사용하여 설정할 수 있습니다.
받은 메시지의 보낸 사람 을 나타내는 SAML 어설션입니다.
함수는 지정된 버퍼를 복제합니다.


이 속성은 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_STATE_EMPTY.
WS_MESSAGE_PROPERTY_SECURITY_CONTEXT
값: 20
이 속성은 WsGetMessageProperty 에서 보안 대화 핸들을 검색하는 데 사용됩니다.
WS_SECURITY_CONTEXT_MESSAGE_SECURITY_BINDING 서버 쪽에서 사용됩니다.


WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 WS_SECURITY_CONTEXT.

반환된 값은 메시지가 해제되거나 다시 설정될 때까지 적합합니다.
WS_MESSAGE_PROPERTY_PROTECTION_LEVEL
값: 21
이 속성은 WsGetMessageProperty 와 함께 메시지의 보안 보호 수준을 검색하는 데 사용됩니다.

WS_MESSAGE_PROPERTY 구조체의 함께 제공되는 값 멤버는 WS_PROTECTION_LEVEL 값입니다.

채널에서 보안을 사용하지 않거나 보안 확인에 실패한 경우 보호 수준이 로 설정됩니다.
WS_PROTECTION_LEVEL_NONE. 그렇지 않으면 애플리케이션에서 요청한 수준으로 설정됩니다.


이 속성은 WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS 때 보안 확인의 상태 확인하는 데 사용할 수 있습니다.
가 FALSE로 설정됩니다.


사용자 지정 채널은 WsSetMessageProperty 를 사용하여 설정할 수 있습니다.
받은 메시지의 보호 수준입니다.


이 속성은 제외한 모든 메시지 상태에서 사용할 수 있습니다.
WS_MESSAGE_STATE_EMPTY.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
머리글 webservices.h