Compartilhar via

Função WsWriteValue (webservices.h)

  • Artigo

Essa operação deriva a melhor representação para um valor primitivo da codificação subjacente e passa o valor derivado para um objeto Writer.

Nota Geralmente, é mais eficiente usar essa função para gravar valores primitivos em vez de converter o valor em texto e, posteriormente, usar WsWriteChars.

 

Sintaxe

HRESULT WsWriteValue(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_VALUE_TYPE valueType,
                 const void    *value,
  [in]           ULONG         valueSize,
  [in, optional] WS_ERROR      *error
);

Parâmetros

[in] writer

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

[in] valueType

Indica o Tipo de valor primitivo referenciado pelo parâmetro value .

I

value

Um ponteiro nulo para o valor primitivo.

[in] valueSize

O tamanho em bytes do valor que está sendo gravado.

[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

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