Add Method (IBodyParts)

Topic Last Modified: 2006-06-13

Adds a new BodyPart object to the collection.

Applies To

IBodyParts Interface

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In

CDOEX.DLL

Syntax

Function Add(    ByVal [Index As Long]) As IBodyPart
HRESULT Add
(
        long Index,
        IBodyPart** pVal
);

Parameters

  • Index
    The ordinal index within the collection at which the new object is to be added. The first element in the collection has an index of 1, and the last element has an index equal to Count. Setting Index to 1 causes the new object to be inserted at the beginning of the collection. Setting Index to -1 causes the new object to be appended to the collection. Index settings of 0 or less than -1 are invalid.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Index allows a BodyPart object to be inserted into a specific location in the collection.

If an object already exists in the collection with the index you specify, then that object and all following objects have their index increased by one, and the object is then inserted. Insertion with the Add method does not replace the object at the index you specify.

The content-type for the newly added BodyPart object defaults to "application/octet-stream".

The content-disposition for the newly added BodyPart object defaults to "attachment" if the BodyParts collection contains attachments (that is, it was retrieved using an Attachments property on another object, such as the Message object). The "filename" attribute parameter, however, is not set automatically.

Example

Dim iMsg as New CDO.Message
Dim iBp as IBodyPart
Dim iBps as IBodyParts

Set iBps = iMsg.BodyPart.BodyParts
Set iBp = iBps.Add
...