Função WsWriteElement (webservices.h)

Escreva um valor tipado como um elemento XML.

Sintaxe

HRESULT WsWriteElement(
  [in]           WS_XML_WRITER                *writer,
  [in]           const WS_ELEMENT_DESCRIPTION *elementDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *value,
  [in]           ULONG                        valueSize,
  [in, optional] WS_ERROR                     *error
);

Parâmetros

[in] writer

O gravador para o qual gravar o elemento.

[in] elementDescription

Um ponteiro para uma descrição de como serializar o elemento.

[in] writeOption

Informações sobre como o valor é alocado. Consulte WS_WRITE_OPTION para obter mais informações.

value

Um ponteiro para o valor a ser serializado.

[in] valueSize

O tamanho do valor que está sendo serializado, em bytes.

Se o valor for NULL, o tamanho deverá ser 0.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno	Descrição
WS_E_INVALID_FORMAT	Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
E_INVALIDARG	Um ou mais argumentos são inválidos.
E_OUTOFMEMORY	Ficou sem memória.

Comentários

Essa API grava o elemento start, os atributos, os elementos filho/texto e o elemento final que corresponde ao valor especificado.

Se a API falhar, o estado do gravador de entrada ficará indefinido. As únicas APIs que podem ser usadas no gravador se isso ocorrer são WsSetOutput e WsSetOutputToBuffer para retornar o gravador a um estado utilizável ou WsFreeWriter para liberar o gravador.

Requisitos

Requisito	Valor
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