The IMAPIContainer::GetContentsTable method returns a pointer to the container's contents table.
See IMAPIContainer : IMAPIProp.
HRESULT GetContentsTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
The IMAPIContainer::GetContentsTable method returns a pointer to the contents table of a container. A contents table contains summary information about objects within the container.
Contents tables have lengthy column sets. For a complete list of the required and optional columns in contents tables, see Contents Tables.
It is possible for some containers to have no contents. These containers return MAPI_E_NO_SUPPORT from their implementations of GetContentsTable.
If you support a contents table for your container, you must also:
A remote transport provider's implementation of this method must return a pointer to an IMAPITable interface in the ppTable parameter passed into the GetContentsTable method. If your transport provider has an existing contents table, it suffices to return a pointer to it. If not, then this method must create a new IMAPITable object, populate the table with message headers (if any are available), and return a pointer to the new table. The ITableData method HrGetView is useful for generating a return value and storing the table pointer in the ppTable parameter. The contents table must support at least the following property columns:
String and binary contents table columns can be truncated. Typically, providers return 255 characters. Because you cannot know ahead of time whether or not a table includes truncated columns, assume that a column is truncated if the length of the column is either 255 or 510 bytes. You can always retrieve the full value of a truncated column if necessary from the object directly by using its entry identifier to open it and then calling the IMAPIProp::GetProps method.
Depending on the provider's implementation, restrictions and sorting operations can apply to an entire string or to the truncated version of that string.
IMAPIProp::GetPropList, IMAPIProp::GetProps, IMAPIProp::OpenProperty, IMAPITable : IUnknown, PR_CONTAINER_CONTENTS