IFillLockBytes：：FillAppend 方法 (objidl.h)

FillAppend方法會將新的位元組區塊寫入位元組陣列結尾。

語法

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

參數

[in] pv

要附加至現有位元組陣列結尾之資料的指標。 這項作業不會造成記憶體流失或緩衝區溢位的威脅。

[in] cb

pv的大小，以位元組為單位。

[out] pcbWritten

已成功寫入的位元組數目。

傳回值

此函式支援標準傳回值E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG和E_FAIL。

備註

FillAppend方法用於循序下載，其中位元組會以接收位元組陣列的順序寫入位元組陣列的結尾。 這個方法會取得位元組陣列的目前大小 (例如，lockbytes 物件) ，並將新的資料區塊寫入陣列結尾。 當每個資料區塊變成可用時，下載程式會呼叫這個方法，將它寫入位元組陣列。 複合檔案實作對 ILockBytes：：ReadAt 的後續呼叫會傳回任何可用的資料，如果目前無法使用資料，則傳回E_PENDING。

需求

另請參閱

ILockBytes