PR_PROVIDER_ICON_W

PR_PROVIDER_ICON_W

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

Quick Info

Exposed by: Profile section objects
Identifier: 0x3417
Property type: PT_UNICODE
Property tag: 0x3417001F
Access: Read/write

Remarks

This property specifies the resource file that contains a custom icon representing a MAPI provider in an online state, and optionally, another custom icon in the offline state. Outlook always requests this property 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.

See Also

About MAPI Additions

Additional MAPI Constants