PidTagProviderIcon Canonical Property

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.

Contains a Unicode string that specifies a custom icon or icons to be displayed for a MAPI provider in the Microsoft Office Outlook status bar in both online and offline states.

Associated properties:

PR_PROVIDER_ICON, PR_PROVIDER_ICON_W

Identifier:

0x3417

Data type:

PT_UNICODE

Area:

MAPI message store

Remarks

These properties specify the resource file that contains a custom icon that represents a MAPI provider in an online state, and optionally, another custom icon in the offline state. Outlook always requests these properties in Unicode representation.

For example, the following property value instructs Outlook to load icon ID 1001 from the module mymod32.dll and use that icon for the online state: mymod32.dll,#1001. Since there is no provider-specific icon for the offline state, in this case, the standard Outlook offline icon is used in the status bar.

The following property value instructs Outlook to load icon ID 1001 from the module mymod32.dll and use that icon for the online state, and to also load icon ID 1002 from this same module to be used for the offline state: mymod32.dll,#1001,#1002. No Outlook icon is used in the status bar.

By default, if no custom icons are specified, the provider is represented by the Outlook default icons for the online state and the offline state. The provider can optionally specify a display name to be shown adjacent to the icon in the status bar. For more information, see PR_PROVIDER_DISPLAY_NAME_W (PidTagProviderDisplayName).

Header Files

  • Mapidefs.h
    Provides data type definitions.

  • Mapitags.h
    Contains definitions of properties listed as alternate names.

See Also

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names