Funzione WsWriteBytes (webservices.h)

Articolo
03/03/2024

Scrive byte nel writer in un formato ottimizzato per la codifica. Quando si scrive in una codifica di testo, genera i byte codificati in base64. Quando si scrive in un formato binario, verrà generato direttamente i byte.

Sintassi

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Parametri

[in] writer

Writer a cui verranno scritti i byte.

bytes

Byte da scrivere nel documento.

[in] byteCount

Numero byte da scrivere nel documento.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
WS_E_INVALID_OPERATION	L'operazione non è consentita a causa dello stato corrente dell'oggetto.
WS_E_QUOTA_EXCEEDED	È stata superata una quota.

Commenti

WsWriteBytes può essere chiamato più volte tra WsWriteStartAttribute e WsWriteEndAttribute. Non può essere combinato con WsWriteChars, WsWriteCharsUtf8, WsWriteValue o WsWriteText durante la scrittura di un attributo.

Per la WS_XML_WRITER_MTOM_ENCODING, se il byteCount supera il valore maxInlineByteCount specificato durante WsSetOutput , i byte verranno memorizzati nel buffer e inseriti nella propria parte MIME. In caso contrario, i byte vengono codificati in base64 e inseriti direttamente nel documento.

Per la WS_XML_WRITER_MTOM_ENCODING, se l'elemento contenente i byte ha un attributo con il nome 'contentType' e lo spazio dei nomi 'http://www.w3.org/2004/11/xmlmime', il valore dell'attributo verrà riflesso nell'intestazione del tipo di contenuto per la parte MIME, come descritto in Creazione di pacchetti ottimizzati per xml-binari.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Share via