GetPendingRows

HRESULT GetPendingRows(
DBPENDINGSTATUS dwStatus, 
HROW*& phRows, 
ULONG& cRows, 
DBPENDINGSTATUS **ppStatus);

Parameters

dwStatus

Status bitmask.

phRows

Reference to buffer to receive callee-allocated HROWs array. Use CRowset::FreeRows or a combination of CRowset::ReleaseRows and CoTaskMemFree to release the HROWs and free the callee-allocated buffer.

cRows

The number of HROWs returned.

ppStatus

Pointer to buffer to receive array of DBPENDINGSTATUS flags for each of the HROWs returned. The array is allocated by the callee and must be freed by the caller using CoTaskMemFree.

Return Code

S_OK

Method succeeded.

E_NOINTERFACE
Returned if IRowsetUpdate is not available.

E_FAIL
Returned if the object is not attached.

Comments

Uses IRowsetUpdate::GetPendingRows to retrieve the array or HROWs whose status bit matches any one of the given status bitmasks.