Funzione WsWriteXmlBufferToBytes (webservices.h)

Articolo
03/13/2024

Usa un writer per convertire un WS_XML_BUFFER in un set codificato di byte.

Sintassi

HRESULT WsWriteXmlBufferToBytes(
  [in]           WS_XML_WRITER                *writer,
  [in]           WS_XML_BUFFER                *xmlBuffer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in]           WS_HEAP                      *heap,
                 void                         **bytes,
  [out]          ULONG                        *byteCount,
  [in, optional] WS_ERROR                     *error
);

Parametri

[in] writer

Writer da usare per generare i byte codificati.

[in] xmlBuffer

Buffer XML da scrivere.

[in, optional] encoding

Codifica da usare durante la generazione dei byte. Se NULL, i byte verranno codificati in utf8.

properties

Matrice di proprietà facoltative del writer. Vedere WS_XML_WRITER_PROPERTY.

[in] propertyCount

Numero di proprietà.

[in] heap

Heap da cui allocare i byte.

bytes

I byte generati vengono restituiti qui.

[out] byteCount

Il numero di byte generati viene restituito qui.

[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

La funzione genererà l'intero contenuto della WS_XML_BUFFER come set lineare di byte allocati dall'heap specificato nella codifica specificata.

Il writer verrà lasciato in uno stato non definito dopo aver chiamato questa funzione. Tuttavia, WsWriteXmlBufferToBytes può essere usato di nuovo con tale writer. In caso contrario, WsSetOutput o WsSetOutputToBuffer deve essere usato per riportare il writer a uno stato noto oppure il writer deve essere liberato usando WsFreeWriter.

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

Condividi tramite