Método IFillLockBytes::FillAppend (objidl.h)

O método FillAppend grava um novo bloco de bytes no final de uma matriz de bytes.

Sintaxe

HRESULT FillAppend(
  [in]  const void *pv,
  [in]  ULONG      cb,
  [out] ULONG      *pcbWritten
);

Parâmetros

[in] pv

Ponteiro para os dados a serem acrescentados ao final de uma matriz de bytes existente. Essa operação não cria um perigo de perda de memória ou estouro de buffer.

[in] cb

Tamanho do pv em bytes.

[out] pcbWritten

Número de bytes que foram gravados com êxito.

Valor retornado

Essa função dá suporte aos valores retornados padrão E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL.

Comentários

O método FillAppend é usado para download sequencial, em que os bytes são gravados no final da matriz de bytes na ordem em que são recebidos. Esse método obtém o tamanho atual da matriz de bytes (por exemplo, objeto lockbytes) e grava um novo bloco de dados no final da matriz. À medida que cada bloco de dados se torna disponível, o downloader chama esse método para gravá-lo na matriz de bytes. Chamadas subsequentes da implementação de arquivo composto para ILockBytes::ReadAt retornam todos os dados disponíveis ou retornam E_PENDING se os dados estiverem indisponíveis no momento.

Requisitos

Confira também

ILockBytes