Compartilhar via

Função WsFillReader (webservices.h)

  • Artigo

Garante que o leitor tenha armazenado em buffer a contagem mínima de bytes de dados XML para uso por funções de leitor subsequentes. Ele invocará o retorno de chamada especificado por WS_XML_READER_STREAM_INPUT quantas vezes forem necessárias para obter o número de bytes especificado pelo valor do parâmetro minSize . Ao concluir, os dados armazenados em buffer estão disponíveis para outras funções de leitor. Se uma função de leitor subsequente exigir mais dados do que o que foi obtido, a função retornará uma exceção WS_E_QUOTA_EXCEEDED . (Consulte Valores retornados dos Serviços Web do Windows.)

Sintaxe

HRESULT WsFillReader(
  [in]           WS_XML_READER          *reader,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parâmetros

[in] reader

Um ponteiro para uma estrutura de WS_XML_READER usada para obter os dados.

[in] minSize

Especifica o número mínimo de bytes que o leitor deve ter obtido. Se a contagem de bytes atual armazenada em buffer for igual ou maior que o valor de minSize , a função não fará nada e retornará imediatamente.

[in, optional] asyncContext

Um ponteiro para um WS_ASYNC_CONTEXT estrutura de dados com informações sobre como invocar a função de forma assíncrona. Um valor NULL indica uma solicitação de operação síncrona.

[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.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
WS_S_ASYNC
 A operação assíncrona ainda está pendente.

Comentários

O número de bytes necessários para ler um segmento específico de dados XML depende da codificação e de sua formatação.

Essa função é uma "no-op" quando usada com um leitor usando WS_XML_READER_BUFFER_INPUT.

Ao especificar um WS_ASYNC_CONTEXT os dados são lidos de forma assíncrona.

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