Funzione WsReadXmlBufferFromBytes (webservices.h)

Articolo
03/03/2024

Usa un lettore per convertire un set di byte codificati in un WS_XML_BUFFER.

Sintassi

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

Parametri

[in] reader

Lettore da usare per analizzare i byte codificati.

[in, optional] encoding

Codifica da utilizzare durante l'analisi dei byte. Se NULL, verrà utilizzato un WS_XML_READER_TEXT_ENCODING con un set di caratteri di WS_CHARSET_AUTO .

properties

Matrice di proprietà facoltative del lettore. Vedere WS_XML_READER_PROPERTY.

[in] propertyCount

Numero di proprietà.

bytes

Byte da analizzare.

[in] byteCount

Numero di byte da analizzare.

[in] heap

Heap da cui allocare il buffer XML.

xmlBuffer

Il buffer XML in cui sono stati letti i byte viene restituito qui.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore 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 analizzerà l'intero contenuto in base alla codifica specificata e lo archivierà in un WS_XML_BUFFER.

Il lettore verrà lasciato in uno stato non definito dopo aver chiamato questa funzione. Tuttavia, WsReadXmlBufferFromBytes può essere usato di nuovo con un lettore di questo tipo. In caso contrario, WsSetInput o WsSetInputToBuffer deve essere usato per riportare il lettore a uno stato noto oppure il lettore deve essere liberato tramite WsFreeReader.

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