IMAPITable : IUnknown

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Provides a read-only view of a table. IMAPITable is used by clients and service providers to manipulate the way a table appears.

Header file:	Mapidefs.h
Exposed by:	Table objects
Implemented by:	Service providers and MAPI
Called by:	Client applications, service providers
Interface identifier:	IID_IMAPITable
Pointer type:	LPMAPITABLE

Vtable Order

GetLastError	Returns a MAPIERROR structure containing information about the previous error on the table.
Advise	Registers to receive notification of specified events affecting the table.
Unadvise	Cancels the sending of notifications previously set up with a call to the IMAPITable::Advise method.
GetStatus	Returns the table's status and type.
SetColumns	Defines the particular properties and order of properties to appear as columns in the table.
QueryColumns	Returns a list of columns for the table.
GetRowCount	Returns the total number of rows in the table.
SeekRow	Moves the cursor to a specific position in the table.
SeekRowApprox	Moves the cursor to an approximate fractional position in the table.
QueryPosition	Retrieves the current table row position of the cursor, based on a fractional value.
FindRow	Finds the next row in a table that matches specific search criteria.
Restrict	Applies a filter to a table, reducing the row set to only those rows matching the specified criteria.
CreateBookmark	Marks the table's current position.
FreeBookmark	Releases the memory associated with a bookmark.
SortTable	Orders the rows of the table based on sort criteria.
QuerySortOrder	Retrieves the current sort order for a table.
QueryRows	Returns one or more rows from a table, beginning at the current cursor position.
Abort	Stops any asynchronous operations currently in progress for the table.
ExpandRow	Expands a collapsed table category, adding the leaf rows belonging to the category to the table view.
CollapseRow	Collapses an expanded table category, removing the leaf rows belonging to the category from the table view.
WaitForCompletion	Suspends processing until one or more asynchronous operations in progress on the table have completed.
GetCollapseState	Returns the data necessary to rebuild the current collapsed or expanded state of a categorized table.
SetCollapseState	Rebuilds the current expanded or collapsed state of a categorized table using data that was saved by a prior call to the IMAPITable::GetCollapseState method.

See Also

Concepts

MAPI Interfaces