External Agent COM API Reference Guide › API Interfaces: Generating EVF Files › COM object: WGNRDILib::WgnImportConnector › Interface IWgnImportConnector › Method ImportMAPIMessage

Method ImportMAPIMessage

Use this method to import a message.

HRESULT ImportMAPIMessage(
    [in] IUnknown    *message,
    [in] BSTR        messageID,
    [in] DWORD       importSource
);

Where:

message

Is the interface pointer to a MAPI IMessage object

messageID

Is a string that uniquely identifies the message in the archive. This will be the string given to CA's Remote Data Manager (RDM) to enable it to retrieve the message contents. But see the warning below.

Important!  The messageID parameter is critical! You can use any string as the identifier but it must be unique and the identifiers must be managed correctly to ensure that CA DataMinder can retrieve the full details for imported e-mails. Your application must be able to use this string, when called by the RDM, to access the exact same message.

importSource

Is the archive identifier.

Return values for ImportMAPIMessage method

E_INVALIDARG 0x80070057

Indicates that an invalid argument was passed to the method.

0xE5630D2E

Indicates an unknown import source. This value is returned if the importSource parameter is set to an invalid number.

0xE5630D18

"A mail event could not be created because the available disk space was less than the configured threshold."

This error message may indicate that the cache is not being cleared quickly enough. If you get this error, wait before retrying to import the e-mail. If you continue to get this error, then you must halt the archive process and flag an alert.