Funzione WsWriteChars (webservices.h)

Articolo
03/15/2023

Scrive una serie di caratteri in un elemento o attributo.

Per scrivere caratteri in un valore di attributo, chiamare prima WsWriteStartAttribute . Solo gli spazi vuoti possono essere scritti nella radice di un documento xml, a meno che il WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT non sia stato impostato su TRUE.

Sintassi

HRESULT WsWriteChars(
  [in]           WS_XML_WRITER *writer,
                 const WCHAR   *chars,
  [in]           ULONG         charCount,
  [in, optional] WS_ERROR      *error
);

Parametri

[in] writer

Puntatore all'oggetto WS_XML_WRITER in cui vengono scritti i caratteri. Il puntatore deve fare riferimento a un oggetto Writer XML valido.

chars

Puntatore ai caratteri da scrivere.

[in] charCount

Numero di caratteri da scrivere.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate 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 .

Commenti

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

Requisiti


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