Click or drag to resize

IMailStoreExtractorGetMessagesByNodeId Method

Gets a specific message objects from the mail store as ChildDocument objects. It is important to see the remarks.

Namespace: OpenDiscoverSDK.Interfaces.Extractors
Assembly: OpenDiscoverSDK.Interfaces (in OpenDiscoverSDK.Interfaces.dll) Version: 2025.4.6.0 (2025.4.6)
Syntax
C#
Copy
IEnumerable<ChildDocument> GetMessagesByNodeId(
	List<long> childNodeIds
)

Parameters

childNodeIds  ListInt64
A list of NodeId values that identify the message objects to retrieve. See remarks.

Return Value

IEnumerableChildDocument
Native email message object as a ChildDocument. The email object's native binary data is contained in the DocumentBytes property.
Remarks

Do NOT mix use of methods GetNextMessage and GetMessagesByNodeId(ListInt64) using the same IMailStoreExtractor instance.

The email object's native data is contained in the DocumentBytes property.

This method is only useful if the user has extracted the mail store's message objects once before and has stored the NodeId field. Individual message objects can then be exported from the mail store container at a later date using the NodeId as the argument to this method.

For Outlook PST/OST mail stores the node ID is the internal node ID of the PST/OST mail store. For all other supported mail store formats NodeId is the same as Index, that is, all message node IDs are zero-offset and sequential. This method is not supported by format OutlookForMacMailbox.

NOTE: For MBOX type mail store containers if the input argument node ID list is not in ascending order, then the order the message objects are returned by the enumerator will be different than the order of childNodeIds list, so check the NodeId of the returned message object(s).

See Also