Función WsWriteText (webservices.h)

  • Artículo

Escribe el texto especificado en el sistema de escritura XML.

Para escribir caracteres en un valor de atributo, llame a WsWriteStartAttribute. Solo se pueden escribir caracteres de espacio en blanco en la raíz de un documento xml a menos que el WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT se haya establecido en TRUE.

Sintaxis

HRESULT WsWriteText(
  [in]           WS_XML_WRITER     *writer,
  [in]           const WS_XML_TEXT *text,
  [in, optional] WS_ERROR          *error
);

Parámetros

[in] writer

Puntero al objeto WS_XML_WRITER en el que se escribe el texto. El puntero debe hacer referencia a un objeto xml Writer válido.

[in] text

Puntero al texto que se va a escribir.

Nota Consulte WS_XML_TEXT y sus clases derivadas para obtener más información sobre el objeto de texto.

 

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
E_INVALIDARG
 Uno o más argumentos no son válidos.
WS_E_INVALID_OPERATION
 No se permite la operación debido al estado actual del objeto .

Comentarios

Solo se puede llamar a WsWriteText una vez entre WsWriteStartAttribute y WsWriteEndAttribute a menos que el tipo de texto sea uno de los siguientes:

  • WS_XML_TEXT_TYPE_UTF8
  • WS_XML_TEXT_TYPE_UTF16
  • WS_XML_TEXT_TYPE_BASE64
Nota Si el tipo de texto se establece en cualquiera de los valores anteriores, se puede llamar a WsWriteText más de una vez. Sin embargo, el tipo de texto debe ser el mismo para todas las llamadas dentro de un atributo.
 

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll