Funzione WsWriteText (webservices.h)

Articolo
08/27/2023

Scrive il testo specificato nel writer XML.

Per scrivere caratteri in un valore dell'attributo, chiamare WsWriteStartAttribute. Solo i caratteri di 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 WsWriteText(
  [in]           WS_XML_WRITER     *writer,
  [in]           const WS_XML_TEXT *text,
  [in, optional] WS_ERROR          *error
);

Parametri

[in] writer

Puntatore all'oggetto WS_XML_WRITER a cui viene scritto il testo. Il puntatore deve fare riferimento a un oggetto Writer XML valido.

[in] text

Puntatore al testo da scrivere.

Nota Per altre informazioni sull'oggetto testo, vedere WS_XML_TEXT e le relative classi derivate.

[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

WsWriteText può essere chiamato una sola volta tra WsWriteStartAttribute e WsWriteEndAttribute , a meno che il tipo di testo non sia uno dei seguenti:

WS_XML_TEXT_TYPE_UTF8
WS_XML_TEXT_TYPE_UTF16
WS_XML_TEXT_TYPE_BASE64

Nota Se il tipo di testo è impostato su uno dei valori precedenti WsWriteText può essere chiamato più di una volta. Tuttavia, il tipo di testo deve essere uguale per tutte le chiamate all'interno 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

Share via