Compartilhar via

WS_READ_CALLBACK função de retorno de chamada (webservices.h)

  • Artigo

Usado pelo WS_XML_READER para ler de alguma origem em um buffer.

Sintaxe

WS_READ_CALLBACK WsReadCallback;

HRESULT WsReadCallback(
  [in]           void *callbackState,
                 void *bytes,
  [in]           ULONG maxSize,
  [out]          ULONG *actualSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

Parâmetros

[in] callbackState

Um ponteiro nulo para o valor de estado definido pelo usuário que foi passado para a função que aceitou esse retorno de chamada.

bytes

Um ponteiro nulo para o local onde os dados devem ser colocados.

[in] maxSize

O número máximo de bytes que podem ser lidos.

[out] actualSize

Um ponteiro para um valor ULONG que indica o número de bytes realmente lidos. Isso pode ser menor que maxSize. Retornar 0 indica que não há mais dados.

[in, optional] asyncContext

Um ponteiro para uma estrutura WS_ASYNC_CONTEXT que contém informações sobre como invocar a função de forma assíncrona. Atribuído NULL se invocar de forma síncrona.

[in, optional] error

Um ponteiro para WS_ERROR estrutura de dados em que informações de erro adicionais devem ser armazenadas se a função falhar.

Valor retornado

Essa função de retorno de chamada não retorna um valor.

Comentários

O tamanho de retorno de 0 no parâmetro de saída actualSize indica o final do arquivo.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho webservices.h