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

Vedi anche

ILockBytes