MAPIDeleteMail (VB)
The Visual Basic MAPIDeleteMail function deletes a message.
Quick Info
Header file: |
MAPIVB32.BAS |
MAPIDeleteMail(
Session as Long,
UIParam as Long,
MessageID as String,
Flags as Long,
Reserved as Long) as Long
Parameters
-
Session
-
[in] Session handle that represents a valid Simple MAPI session. The value of the Session parameter cannot be zero.
-
UIParam
-
[in] Parent window handle or zero, indicating that if a dialog box is displayed, it is application modal. If no dialog box is displayed during the call, the UIParam parameter is ignored.
-
MessageID
-
[in] Identifier for the message to be deleted. This string identifier is messaging system-specific and will be invalid when the MAPIDeleteMail function successfully returns. Both the MAPIFindNext and MAPISaveMail functions return message identifiers.
-
Flags
-
Reserved; must be zero.
-
Reserved
-
Reserved; must be zero.
Return Values
-
MAPI_E_FAILURE
-
One or more unspecified errors occurred while deleting the message. No message was deleted.
-
MAPI_E_INSUFFICIENT_MEMORY
-
There was insufficient memory to proceed. No message was deleted.
-
MAPI_E_INVALID_MESSAGE
-
An invalid message identifier was passed in for the MessageID parameter. No message was deleted.
-
MAPI_E_INVALID_SESSION
-
An invalid session handle was passed in for the Session parameter. No message was deleted.
-
SUCCESS_SUCCESS
-
The call succeeded and the message was deleted.
Remarks
To find the message to be deleted, call the MAPIFindNext function before calling MAPIDeleteMail.
The declaration of this function for the 32-bit Visual Basic runtime is:
MAPIDeleteMail(
ByVal Session&,
ByVal UIParam&,
ByVal MsgID$,
ByVal Flags&,
ByVal Reserved&) As Long