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

El método FillAppend escribe un nuevo bloque de bytes al final de una matriz de bytes.

Sintaxis

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

Parámetros

[in] pv

Puntero a los datos que se van a anexar al final de una matriz de bytes existente. Esta operación no crea un peligro de pérdida de memoria o una saturación del búfer.

[in] cb

Tamaño de pv en bytes.

[out] pcbWritten

Número de bytes que se escribieron correctamente.

Valor devuelto

Esta función admite los valores devueltos estándar E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG y E_FAIL.

Comentarios

El método FillAppend se usa para la descarga secuencial, donde los bytes se escriben al final de la matriz de bytes en el orden en que se reciben. Este método obtiene el tamaño actual de la matriz de bytes (por ejemplo, el objeto lockbytes) y escribe un nuevo bloque de datos al final de la matriz. A medida que cada bloque de datos está disponible, el descargador llama a este método para escribirlo en la matriz de bytes. Las llamadas posteriores realizadas por la implementación del archivo compuesto a ILockBytes::ReadAt devuelven los datos disponibles o devuelven E_PENDING si los datos no están disponibles actualmente.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	objidl.h
Library	Uuid.lib
Archivo DLL	Ole32.dll

Consulte también

ILockBytes