Platform SDK: MAPI

Implementing Standard Form Verbs

MAPI defines a set of standard verbs, or actions taken when a user makes a menu selection or clicks a button, that all form viewers should support. Each verb has a constant associated with it for identification, defined in the EXCHFORM.H header file. The following table lists the standard form verbs and their associated constants:

Verb Value
Open EXCHIVERB_OPEN
Reply EXCHIVERB_REPLYTOSENDER
Reply to All EXCHIVERB_REPLYTOALL
Forward EXCHIVERB_FORWARD
Print EXCHIVERB_PRINT
Save As EXCHIVERB_SAVEAS
Reply to Folder EXCHIVERB_REPLYTOFOLDER

When a user chooses a verb, pass its constant in a call to the form's IMAPIForm::DoVerb method to perform its corresponding action.

In addition to accessing verbs through your form viewer, users can sometimes access verbs directly from the form. For example, some form objects allow the user to invoke the Print verb by right-clicking on the form and choosing Print from a context-sensitive menu.

For compatability with Microsoft Mail 3.x, some reserved verbs are also defined. These verbs have constants that start with EXCHIVERB_RESERVED. These should not be passed to DoVerb, although future versions of MAPI may make use of them.