Contents Index Topic Contents
	Previous Topic: IABTable::Restrict Next Topic: IABTable::SeekRowApprox

IABTable::SeekRow

HRESULT SeekRow(
    BOOKMARK bkOrigin,
    LONG lRowCount,
    LONG FAR * lplRowsSought
);

Moves the table cursor to a specific position.

• Returns one of the following values:

  S_OK	The seek operation was successful.
  MAPI_E_BUSY	Another operation is in progress that prevents the row seeking operation from starting. Either the operation in progress should be allowed to complete, or it should be stopped.
  MAPI_E_INVALID_BOOKMARK	The bookmark specified in the bkOrigin parameter is invalid because it has been removed or because it is beyond the last row requested.
  MAPI_W_POSITION_CHANGED	The call succeeded, but the bookmark specified in the bkOrigin parameter is no longer set at the same row as when it was last used. If the bookmark has not been used, it is no longer in the same position as when it was created. When this warning is returned, the call should be handled as successful. To test for this warning, use the FAILED macro.

bkOrigin

Bookmark identifying the starting position for the seek operation. A bookmark can be created using the CreateBookmark method, or one of the following predefined values can be passed:

BOOKMARK_BEGINNING	Starts the seek operation from the beginning of the table.
BOOKMARK_CURRENT	Starts the seek operation from the row in the table where the cursor is located.
BOOKMARK_END	Starts the seek operation from the end of the table.

lRowCount

Signed count of the number of rows to move, starting from the bookmark identified by the bkOrigin parameter.

lplRowsSought

If lplRowsSought is a valid pointer on input, on output it points to the number of rows that were processed in the seek operation. If lplRowsSought is NULL on input, the indication is the caller is not interested in the number of rows processed, and nothing is returned on output.

Back to top

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.