Share via


IProfAdmin::GetProfileTable

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 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] Always NULL.

  • 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.

See Also

Reference

IMAPITable : IUnknown

MAPILogonEx

IProfAdmin : IUnknown

Concepts

MFCMAPI as a Code Sample