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

  • Artigo

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:

Código de retorno Descrição
E_NOTIMPL A matriz de bytes não dá suporte ao método FillAt .

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.

Nota A implementação IFillLockBytes fornecida pelo sistema não dá suporte a FillAt e retorna E_NOTIMPL.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidl.h
Biblioteca Uuid.lib
DLL Ole32.dll

Confira também

IFillLockBytes – Implementação

IFillLockBytes::FillAppend

ILockBytes::ReadAt