This documentation is archived and is not being maintained.

Visual Basic: MAPI Controls

Visual Studio 6.0

Action Property (MAPISession Control)

See Also    Example    Applies To

Determines what action is performed when the MAPISession control is invoked. This property is not available at design time. Setting the Action property at run time invokes the control. The Action property is write-only at run time.

Note   The Action property is included for compatibility with earlier versions of Visual Basic. For additional functionality, use the new methods listed in the Methods list for the MAPISession control.


object.Action [ = value ]

The Action property syntax has these parts:

Part Description
object An object expression that evaluates to an object in the Applies To list.
value An integer expression specifying the action to perform, as described in Settings.


The settings for value are:

Constant Value Description
mapSignOn 1 Logs user into the account specified by the UserName and Password properties and provides a session handle to the underlying message subsystem. The session handle is stored in the SessionID property.

Depending on the value of the NewSession property, the session handle may refer to a newly created session or an existing session.

mapSignOff 2 Ends the messaging session and signs the user off the specified account.


This property is used to select between signing on and signing off from a messaging session. When signing on, a session handle is returned in the SessionID property.

Data Type