Compartilhar via

Função WsWriteText (webservices.h)

  • Artigo

Grava o texto especificado no gravador XML.

Para gravar caracteres em um valor de atributo, chame WsWriteStartAttribute. Somente caracteres de espaço em branco podem ser gravados na raiz de um documento xml, a menos que o WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT tenha sido definido como TRUE.

Sintaxe

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

Parâmetros

[in] writer

Um ponteiro para o objeto WS_XML_WRITER no qual o texto é gravado. O ponteiro deve referenciar um objeto gravador XML válido.

[in] text

Um ponteiro para o texto a ser gravado.

Nota Consulte WS_XML_TEXT e suas classes derivadas para obter mais informações sobre o objeto de texto.

 

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Valor retornado

Essa função pode retornar um desses valores.

Código de retorno Descrição
E_INVALIDARG
 Um ou mais argumentos são inválidos.
WS_E_INVALID_OPERATION
 A operação não é permitida devido ao estado atual do objeto.

Comentários

WsWriteText só pode ser chamado uma vez entre WsWriteStartAttribute e WsWriteEndAttribute , a menos que o tipo de texto seja um dos seguintes:

  • WS_XML_TEXT_TYPE_UTF8
  • WS_XML_TEXT_TYPE_UTF16
  • WS_XML_TEXT_TYPE_BASE64
Nota Se o texto Tipo for definido como qualquer um dos valores anteriores, WsWriteText poderá ser chamado mais de uma vez. No entanto, o tipo de texto deve ser o mesmo para todas as chamadas dentro de um atributo.
 

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll