Condividi tramite


Funzione WsWriteText (webservices.h)

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