Metodo IFillLockBytes::FillAppend (objidl.h)
Il metodo FillAppend scrive un nuovo blocco di byte alla fine di una matrice di byte.
Sintassi
HRESULT FillAppend(
[in] const void *pv,
[in] ULONG cb,
[out] ULONG *pcbWritten
);
Parametri
[in] pv
Puntatore ai dati da aggiungere alla fine di una matrice di byte esistente. Questa operazione non crea un pericolo di perdita di memoria o di un sovraccarico del buffer.
[in] cb
Dimensioni di pv in byte.
[out] pcbWritten
Numero di byte scritti correttamente.
Valore restituito
Questa funzione supporta i valori restituiti standard E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL.
Commenti
Il metodo FillAppend viene usato per il download sequenziale, in cui i byte vengono scritti alla fine della matrice di byte nell'ordine in cui vengono ricevuti. Questo metodo ottiene le dimensioni correnti della matrice di byte (ad esempio, l'oggetto lockbytes) e scrive un nuovo blocco di dati alla fine della matrice. Man mano che ogni blocco di dati diventa disponibile, il downloader chiama questo metodo per scriverlo nella matrice di byte. Le chiamate successive dall'implementazione del file composto a ILockBytes::ReadAt restituiscono i dati disponibili o restituiscono E_PENDING se i dati non sono attualmente disponibili.
Requisiti
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | objidl.h |
| Libreria | Uuid.lib |
| DLL | Ole32.dll |