Condividi tramite


Funzione WsWriteChars (webservices.h)

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