Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ParameterDescription
sessionContains a MAPI session handle returned by MAPILogon. If not specified a system default session will be initiated, if possible, or a sign-in dialog box will be displayed. In any case, MAPI will return to its previous state upon completion of the function.
parentContains the name of an OpenInsight parent window. If not specified the dialog box will be application modal.
flagsContains information about session initiation and detail modification. It could be MAPI_LOGON_UI$, MAPI_NEW_SESSION$, MAPI_DIALOG$, MAPI_AB_NOMODIFY$, or a combination of these flags.
  • MAPI_LOGON_UI$ indicates that MAPI should display a sign-in dialog box, if necessary. If the session parameter is specified this flag is ignored.
  • MAPI_NEW_SESSION$ indicates that MAPI should establish a new session and not attempt to share another MAPI client's session or the default session. If the session parameter is specified this flag is ignored.
  • MAPI_DIALOG$ indicates that MAPI should display a dialog box to resolve ambiguous names.
  • MAPI_AB_NOMODIFY$ indicates that the details may not be modified even if they belong to the personal address book.

The insert record MAPI_EQUATES contains these flags. You may combine flags by adding them together with an addition sign (+).

nameContains the name of the address book entry whose details are to be displayed.

...

If function execution fails, you can retrieve a text error message by calling the Get_Status function. For example, to display an error message on the screen, include the following error handling routine in your code:

Code Block
Get_Status(ErrMsg)
Msg(@window, ErrMsg)

See also

Get_Status()MAPIAddress()

...