Compartilhar via

Função WsWriteChars (webservices.h)

  • Artigo

Grava uma série de caracteres em um elemento ou atributo.

Para gravar caracteres em um valor de atributo, chame WsWriteStartAttribute primeiro. 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 WsWriteChars(
  [in]           WS_XML_WRITER *writer,
                 const WCHAR   *chars,
  [in]           ULONG         charCount,
  [in, optional] WS_ERROR      *error
);

Parâmetros

[in] writer

Um ponteiro para o objeto WS_XML_WRITER no qual os caracteres são gravados. O ponteiro deve referenciar um objeto gravador XML válido.

chars

Um ponteiro para os caracteres a serem gravados.

[in] charCount

O número de caracteres a serem gravados.

[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

WsWriteChars pode ser chamado mais de uma vez entre WsWriteStartAttribute e WsWriteEndAttribute. Ele não pode ser combinado com WsWriteCharsUtf8, WsWriteBytes, WsWriteValue ou WsWriteText ao escrever 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