enumeración WS_XML_READER_PROPERTY_ID (webservices.h)

  • Artículo

Identifica cada propiedad de lector XML y su valor asociado. Esta enumeración se usa en la estructura WS_XML_READER_PROPERTY , que se usa como parámetro para WsCreateReader, WsSetInput, WsSetInputToBuffer y WsReadXmlBufferFromBytes. También se usa directamente como parámetro para 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;

Constantes

 
WS_XML_READER_PROPERTY_MAX_DEPTH
Valor: 0
ULONG que especifica la profundidad máxima del documento que permitirá el lector.


La profundidad se mide en cualquier punto por el número de elementos iniciales anidados.


Una profundidad de 0 impide que se lean los elementos de inicio.


Esta propiedad tiene como valor predeterminado 32.


Consulte WsCreateReader para conocer las consideraciones de seguridad.
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT
Valor: 1
Un BOOL que
especifica si el lector permitirá varios elementos y espacios no en blanco en el nivel superior del documento. Esta propiedad
no se puede establecer en TRUE con WS_XML_READER_MTOM_ENCODING.


Esta propiedad tiene como valor predeterminado FALSE.
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES
Valor: 2
ULONG que especifica el número máximo de atributos que el lector permitirá en un elemento.


Esta propiedad tiene como valor predeterminado 128.


Consulte WsCreateReader para conocer las consideraciones de seguridad.
WS_XML_READER_PROPERTY_READ_DECLARATION
Valor: 3
BoOL que especifica si el lector debe permitir una declaración xml al principio del documento.


Esta propiedad tiene como valor predeterminado TRUE.
WS_XML_READER_PROPERTY_CHARSET
Valor: 4
Valor WS_CHARSET que devuelve el juego de caracteres del documento xml. Este valor solo está disponible para
documentos de texto.


Si el lector se inicializó con un WS_CHARSET_AUTO , determinará automáticamente esto.
. El origen de entrada del lector se transmite y, a continuación, el lector debe tener suficientes datos almacenados en búfer para poder hacerlo.
inspeccione las marcas de orden de bytes iniciales y la declaración xml. Consulte WsFillReader.


Si el lector se inicializó con cualquier otro valor, esta propiedad simplemente devuelve ese valor.
WS_XML_READER_PROPERTY_ROW
Valor: 5
ULONGLONG que devuelve el número de fila basado en 0 del nodo en el que se coloca el lector para los documentos xml de texto.
WS_XML_READER_PROPERTY_COLUMN
Valor: 6
ULONGLONG que devuelve el número de columna basado en 0 del nodo en el que se coloca el lector para los documentos xml de texto.
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE
Valor: 7
ULONG que especifica el tamaño de recorte del búfer interno utilizado por el
WS_XML_READER para realizar conversiones UTF-16 a UTF-8. Aumento de este valor
usa más memoria, pero puede reducir las asignaciones al procesar documentos codificados con UTF-16.


Esta propiedad tiene como valor predeterminado 4096.
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE
Valor: 8
ULONG que especifica el tamaño del búfer que usará el WS_XML_READER cuando esté configurado para usar
WS_XML_READER_STREAM_INPUT. Aumentar este valor usa más memoria, pero
puede reducir el número de veces que se invoca el WS_READ_CALLBACK .


Esta propiedad tiene como valor predeterminado 4096.
WS_XML_READER_PROPERTY_IN_ATTRIBUTE
Valor: 9
Indica que se ha llamado a WsReadStartAttribute y que el lector es
colocado en el contenido del atributo.
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE
Valor: 10
Un ULONG usado con WS_XML_READER_STREAM_INPUT junto con WS_XML_READER_MTOM_ENCODING.
Este valor especifica el tamaño máximo de la parte MIME raíz, que es la parte que contiene.
parte xml del documento. No tiene ningún efecto cuando se usa con otras codificaciones, o cuando se usa con
WS_XML_READER_BUFFER_INPUT.


Esta propiedad tiene como valor predeterminado 65536.
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE
Valor: 11
Un ULONG usado con WS_XML_READER_STREAM_INPUT junto con WS_XML_READER_MTOM_ENCODING.
Este valor especifica el tamaño máximo de cualquier grupo de encabezados MIME que puedan aparecer en el documento.
No tiene ningún efecto cuando se usa con otras codificaciones o cuando se usa con WS_XML_READER_BUFFER_INPUT.


Esta propiedad tiene como valor predeterminado 256.
WS_XML_READER_PROPERTY_MAX_MIME_PARTS
Valor: 12
ULONG usado con WS_XML_READER_MTOM_ENCODING. Este valor especifica el número máximo de elementos MIME.
que puede aparecer en el documento. No tiene ningún efecto cuando se usa con otras codificaciones.


Esta propiedad tiene como valor predeterminado 4096.
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES
Valor: 13
BoOL usado con WS_XML_READER_TEXT_ENCODING. Si se establece en TRUE , se permiten referencias de caracteres.
de caracteres considerados no válidos por XML 1.0 que se van a aceptar.


Establecer esta propiedad en TRUE puede afectar a la interoperabilidad.


Esta propiedad tiene como valor predeterminado FALSE.
WS_XML_READER_PROPERTY_MAX_NAMESPACES
Valor: 14
ULONG que especifica el número máximo de declaraciones únicas xmlns que pueden aparecer en el ámbito en cualquier momento
al leer el documento.


Esta propiedad tiene como valor predeterminado 32.


Consulte WsCreateReader para conocer las consideraciones de seguridad.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado webservices.h