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

O método FillAt grava um novo bloco de dados em um local especificado na matriz de bytes.

Sintaxe

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

Parâmetros

[in] ulOffset

O deslocamento, expresso em número de bytes, do primeiro elemento da matriz de bytes.

[in] pv

Ponteiro para os dados a serem gravados no local especificado por uIOffset.

[in] cb

Tamanho do pv em bytes.

[out] pcbWritten

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

Retornar valor

Essa função dá suporte aos valores de retorno padrão E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL além do seguinte:

Comentários

O método FillAt é usado para download não sequencial (por exemplo, solicitações de intervalo de bytes HTTP). No download não sequencial, o chamador especifica intervalos na matriz de bytes em que vários blocos de dados devem ser gravados. Chamadas subsequentes da implementação de arquivo composto para ILockBytes::ReadAt são passadas pela implementação do objeto wrapper de matriz de bytes de ILockBytes para a matriz de bytes subjacente. Esse método não está implementado no momento e retornará E_NOTIMPL.

Requisitos

Confira também

IFillLockBytes – Implementação

IFillLockBytes::FillAppend

ILockBytes::ReadAt