IProfAdmin::GetProfileTable
Applies to: Outlook 2013 | Outlook 2016
Provides access to the profile table, a table that contains information about all of the available profiles.
HRESULT GetProfileTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameters
ulFlags
[in] A bitmask of flags that controls how the profile table is populated. The following flag can be set:
MAPI_APP_PROFILE
Include "app" profiles in the profile table. If this flag is not set, "app" profiles are not included.
This flag may not be recognized or supported in all MAPI implementations.
lppTable
[out] A pointer to a pointer to the profile table.
Return value
S_OK
The profile table was successfully retrieved.
Remarks
The IProfAdmin::GetProfileTable method provides access to the profile table, which contains one row for every available profile. There are only two columns in each row: the profile's display name, and a flag that indicates whether the profile is the default.
Profiles that have been deleted, or that are in use but have been marked for deletion, are not included in the profile table. The profile table is static; subsequent additions and deletions of profiles are not reflected in the table.
If no profiles exist, GetProfileTable returns a table with zero rows.
For more information about the profile table, see Profile Tables.
MFCMAPI reference
For MFCMAPI sample code, see the following table.
| File | Function | Comment |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnShowProfiles |
MFCMAPI uses the IProfAdmin::GetProfileTable method to get the profile table to display in a new dialog box. |