HRESULT GetRows(
const CBookmark *pBookmarks,
ULONG cBookmarks,
HROW* phRows,
DBROWSTATUS *pRowStatus = NULL);
Parameters
pBookmarks
Bookmark array.
cBookmarks
The number of bookmarks in the array.
phRows
Reference to buffer to receive HROWs. If this argument is NULL then the callee will allocate an array large enough to hold the number of HROWs returned. Use CRowset::FreeRows, or a combination of CRowset::ReleaseRows and CoTaskMemFree to release the HROWS and free the callee-allocated buffer. If this argument is not NULL, then the caller must have allocated enough space to hold the requested number of HROWs.
pRowStatus
Caller-allocated array to receive the row status for each of the HROWs fetched. This array must contain at least cBookmarks elements.
Return Code
S_OK
Method succeeded.
E_NOINTERFACE
Returned if IRowsetLocate is not available.
E_FAIL
Returned if the object is not attached.
Comments
Uses IRowsetLocate::GetRowsByBookmark to retrieve the HROWs identified by bookmarks in the given bookmark array.