Compartilhar via


Função WsWriteType (webservices.h)

Escreva um valor de um determinado WS_TYPE em XML de acordo com o WS_TYPE_MAPPING.

Sintaxe

HRESULT WsWriteType(
  [in]           WS_XML_WRITER   *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_WRITE_OPTION writeOption,
                 const void      *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Parâmetros

[in] writer

O gravador no qual gravar o valor.

[in] typeMapping

Descreve como o tipo é mapeado para o XML que está sendo gravado.

[in] type

O tipo de valor a serializar.

[in, optional] typeDescription

Informações adicionais sobre o tipo. Cada tipo tem uma estrutura de descrição diferente. Isso pode ser NULL, dependendo do WS_TYPE.

[in] writeOption

Se o valor é necessário e como o valor é alocado. Consulte WS_WRITE_OPTION para obter mais informações.

Esse parâmetro pode ter um dos seguintes valores:

value

Um ponteiro para o valor a ser serializado.

[in] valueSize

O tamanho do valor que está sendo serializado.

[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.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Confira WS_TYPE_MAPPING como usar essa função para gravar valores em elementos e atributos.

Se a API falhar, o estado do gravador de entrada se tornará indefinido. As únicas APIs que poderão 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