Compartilhar via

Função WsSetOutput (webservices.h)

  • Artigo

Define os retornos de chamada de codificação e saída para o gravador. Os retornos de chamada são usados para fornecer buffers para o gravador e para executar e/s assíncronas.

Sintaxe

HRESULT WsSetOutput(
  [in]           WS_XML_WRITER                *writer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
  [in, optional] const WS_XML_WRITER_OUTPUT   *output,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in, optional] WS_ERROR                     *error
);

Parâmetros

[in] writer

O gravador para o qual a saída será definida.

[in, optional] encoding

A codificação descreve o formato dos bytes de entrada. Esse deve ser um dos WS_XML_WRITER_TEXT_ENCODING, WS_XML_WRITER_BINARY_ENCODING ou WS_XML_WRITER_MTOM_ENCODING.

[in, optional] output

Especifica onde o gravador deve colocar seus dados.

properties

Uma matriz de propriedades opcionais do gravador. Consulte WS_XML_WRITER_PROPERTY.

[in] propertyCount

O número de propriedades.

[in, optional] error

Especifica onde informações adicionais de 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.

Comentários

Quando WsSetOutput for usado no gravador, o gravador funcionará de maneira somente para frente e as funções WsGetWriterPosition, WsSetWriterPosition e WsMoveWriter não poderão ser usadas.

Se a codificação for NULL, WS_XML_WRITER_OUTPUT será ignorado e o gravador será configurado para que qualquer tentativa de gravação nele falhe.

Se a codificação não for NULL, WS_XML_WRITER_OUTPUT também deverá ser não NULL .

Se WS_XML_WRITER_OUTPUT for WS_XML_WRITER_BUFFER_OUTPUT , o gravador armazenará em buffer os bytes gerados do documento. Use WsGetWriterProperty com WS_XML_WRITER_PROPERTY_BUFFERS ou WS_XML_WRITER_PROPERTY_BYTES para obter esses bytes. Nesse modo , WsFlushWriter não tem efeito.

Se WS_XML_WRITER_OUTPUT for WS_XML_WRITER_STREAM_OUTPUT , o gravador passará os bytes gerados do documento para o WS_WRITE_CALLBACK especificado durante as chamadas para WsFlushWriter.

O gravador será inicializado para usar as propriedades especificadas em WsCreateWriter. Todas as propriedades especificadas para WsSetOutput substituirão essas propriedades.

Consulte WsCreateWriter para obter os valores padrão das propriedades do gravador.

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