다음을 통해 공유

WS_XML_READER_PROPERTY_ID 열거형(webservices.h)

  • 아티클

각 XML 판독기 속성이 이고 연결된 값을 식별합니다. 이 열거형은 WsCreateReader, WsSetInput, WsSetInputToBuffer 및 WsReadXmlBufferFromBytes에 대한 매개 변수로 사용되는 WS_XML_READER_PROPERTY 구조 내에서 사용됩니다. 또한 WsGetReaderProperty에 대한 매개 변수로 직접 사용됩니다.

Syntax

typedef enum {
  WS_XML_READER_PROPERTY_MAX_DEPTH = 0,
  WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1,
  WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2,
  WS_XML_READER_PROPERTY_READ_DECLARATION = 3,
  WS_XML_READER_PROPERTY_CHARSET = 4,
  WS_XML_READER_PROPERTY_ROW = 5,
  WS_XML_READER_PROPERTY_COLUMN = 6,
  WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7,
  WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8,
  WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9,
  WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10,
  WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11,
  WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12,
  WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13,
  WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14
} WS_XML_READER_PROPERTY_ID;

상수

 
WS_XML_READER_PROPERTY_MAX_DEPTH
값: 0
판독기가 허용할 문서의 최대 깊이를 지정하는 ULONG 입니다.


깊이는 중첩된 시작 요소의 수에 따라 언제든지 측정됩니다.


깊이가 0이면 시작 요소를 읽을 수 없습니다.


이 속성의 기본값은 32입니다.


보안 고려 사항은 WsCreateReader 를 참조하세요.
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT
값: 1
BOOL
는 판독기가 문서의 최상위 수준에서 여러 요소와 공백이 아닌 공간을 허용할지 여부를 지정합니다. 이 속성
는 WS_XML_READER_MTOM_ENCODINGTRUE로 설정되지 않을 수 있습니다.


이 속성의 기본값은 FALSE입니다.
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES
값: 2
판독기가 요소에서 허용할 최대 특성 수를 지정하는 ULONG 입니다.


이 속성의 기본값은 128입니다.


보안 고려 사항은 WsCreateReader 를 참조하세요.
WS_XML_READER_PROPERTY_READ_DECLARATION
값: 3
판독기가 문서의 시작 부분에 xml 선언을 허용해야 하는지를 지정하는 BOOL 입니다.


이 속성은 기본값은 TRUE입니다.
WS_XML_READER_PROPERTY_CHARSET
값: 4
xml 문서의 문자 집합을 반환하는 WS_CHARSET 값입니다. 이 값은 에만 사용할 수 있습니다.
텍스트 문서입니다.


판독기가 WS_CHARSET_AUTO 사용하여 초기화된 경우 자동으로 결정됩니다.
값입니다. 판독기 입력 원본이 스트리밍된 다음 판독기에 버퍼링할 수 있는 충분한 데이터가 있어야 합니다.
는 초기 바이트 순서 표시 및 xml 선언을 검사합니다. WsFillReader를 참조하세요.


판독기가 다른 값으로 초기화된 경우 이 속성은 단순히 해당 값을 반환합니다.
WS_XML_READER_PROPERTY_ROW
값: 5
텍스트 xml 문서에 대해 판독기가 배치된 노드의 0 기반 행 번호를 반환하는 ULONGLONG 입니다.
WS_XML_READER_PROPERTY_COLUMN
값: 6
텍스트 xml 문서에 대해 판독기가 배치된 노드의 0 기반 열 번호를 반환하는 ULONGLONG 입니다.
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE
값: 7
에 사용되는 내부 버퍼의 트리밍 크기를 지정하는 ULONG
UTF-16에서 UTF-8로의 변환을 수행하기 위한 WS_XML_READER. 이 값 증가
는 더 많은 메모리를 사용하지만 UTF-16으로 인코딩된 문서를 처리할 때 할당을 줄일 수 있습니다.


이 속성의 기본값은 4096입니다.
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE
값: 8
사용하도록 구성된 경우 WS_XML_READER 사용할 버퍼의 크기를 지정하는 ULONG
WS_XML_READER_STREAM_INPUT. 이 값을 늘리면 메모리가 더 많이 사용되지만
는 WS_READ_CALLBACK 호출되는 횟수를 줄일 수 있습니다.


이 속성의 기본값은 4096입니다.
WS_XML_READER_PROPERTY_IN_ATTRIBUTE
값: 9
WsReadStartAttribute가 호출되었고 판독기가 임을 나타냅니다.
특성 콘텐츠에 배치됩니다.
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE
값: 10
WS_XML_READER_MTOM_ENCODING 함께 WS_XML_READER_STREAM_INPUT 사용되는 ULONG입니다.
이 값은 루트 MIME 부분의 최대 크기를 지정합니다. 이 부분은 포함됩니다.
문서의 xml 부분입니다. 다른 인코딩과 함께 사용하거나 와 함께 사용할 때는 효과가 없습니다.
WS_XML_READER_BUFFER_INPUT.


이 속성의 기본값은 65536입니다.
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE
값: 11
WS_XML_READER_MTOM_ENCODING 함께 WS_XML_READER_STREAM_INPUT 사용되는 ULONG입니다.
이 값은 문서에 나타날 수 있는 모든 MIME 헤더 그룹의 최대 크기를 지정합니다.
다른 인코딩과 함께 사용하거나 WS_XML_READER_BUFFER_INPUT 사용할 때는 아무런 효과가 없습니다.


이 속성의 기본값은 256입니다.
WS_XML_READER_PROPERTY_MAX_MIME_PARTS
값: 12
WS_XML_READER_MTOM_ENCODING 사용되는 ULONG입니다. 이 값은 MIME 부분의 최대 수를 지정합니다.
문서에 표시할 수 있습니다. 다른 인코딩과 함께 사용하면 아무런 효과가 없습니다.


이 속성의 기본값은 4096입니다.
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES
값: 13
WS_XML_READER_TEXT_ENCODING 사용되는 BOOL입니다. 이를 TRUE 로 설정하면 문자 참조가 허용됩니다.
XML 1.0에서 유효하지 않은 것으로 간주되는 문자의 수입니다.


이 속성을 TRUE 로 설정하면 상호 운용성에 영향을 줄 수 있습니다.


이 속성의 기본값은 FALSE입니다.
WS_XML_READER_PROPERTY_MAX_NAMESPACES
값: 14
언제든지 scope 나타날 수 있는 최대 xmlns 고유 선언 수를 지정하는 ULONG
문서를 읽는 동안


이 속성의 기본값은 32입니다.


보안 고려 사항은 WsCreateReader 를 참조하세요.

요구 사항

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