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 |