estrutura WS_XML_WRITER_RAW_ENCODING (webservices.h)

Usado para indicar que o gravador deve emitir bytes de caracteres base64 decodificados.

Sintaxe

typedef struct _WS_XML_WRITER_RAW_ENCODING {
  WS_XML_WRITER_ENCODING encoding;
} WS_XML_WRITER_RAW_ENCODING;

Membros

encoding

O tipo base para todos os tipos que derivam de WS_XML_WRITER_ENCODING.

Comentários

Essa codificação pode ser útil quando é desejável escrever um documento arbitrário, talvez não xml, enquanto ainda usa a abstração WS_XML_WRITER . Nesta codificação, somente caracteres que representam bytes codificados em base64 podem ser gravados e somente na raiz do documento. Nenhum elemento ou comentário pode ser gravado. O gravador emitirá os bytes representados pelos caracteres codificados em base64. Para acomodar texto não whitespace na raiz do documento, o gravador funcionará como se a propriedade WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT tivesse sido especificada.

Os caracteres base64 do documento só são convertidos em bytes quando necessário. Portanto, por exemplo, usando WsWriteBytes, que normalmente executa uma codificação base64 dos bytes passados, na verdade evita todas as conversões base64 e é a maneira mais eficiente de gravar documentos nessa codificação. O uso de WsWriteChars, por exemplo, fará com que os caracteres base64 sejam decodificados fisicamente para seus bytes correspondentes. Em geral, escrever o documento usando qualquer outra coisa que não seja WsReadBytes, WsPullBytes ou WsPushBytes incorrerá na conversão base64.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho	webservices.h