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