IMAPISession::GetStatusTable

The IMAPISession::GetStatusTable method provides access to the status table, a table with information about all of the MAPI resources in the session.

Quick Info

See IMAPISession : IUnknown2MVW67N.

HRESULT GetStatusTable(

Parameters

ulFlags

[in] Bitmask of flags that determine the format for columns that are character strings. The following flag can be set:

MAPI_UNICODE

The string columns are in the Unicode format. If the MAPI_UNICODE flag is not set, the string columns are in the ANSI format.

lppTable

[out] Pointer to a pointer to the status table.

Return Values

S_OK

The table was successfully returned.

Remarks

The IMAPISession::GetStatusTable method provides access to the status table   a table with information about all of the MAPI resources in the session. There is one row in the table with information about the MAPI subsystem, one row for the MAPI spooler, one row for the integrated address book, and one row for each of the service providers in the profile.

For a complete list of required and optional columns in the status table, see Status Table8IHPH3.

Setting the MAPI_UNICODE flag in the ulFlags parameter affects the format of the columns returned from the following IMAPITable methods:

    IMAPITable::QueryColumns2CQT2TO

    IMAPITable::QueryRowsKPHHB

This flag also controls the property types in the sort order returned by the IMAPITable::QuerySortOrderEWDPDZ method.

See Also