IStreamConcatenate interface (imapi2.h)
Use this interface to combine several data streams into a single stream.
To create an instance of this interface, call the CoCreateInstance function. Use__uuidof(MsftStreamConcatenate) for the class identifier and __uuidof(IStreamConcatenate) for the interface identifier.
Inheritance
The IStreamConcatenate interface inherits from IStream. IStreamConcatenate also has these types of members:
Methods
The IStreamConcatenate interface has these methods.
| IStreamConcatenate::Append Appends a stream to this stream. |
| IStreamConcatenate::Append2 Appends an array of streams to this stream. |
| IStreamConcatenate::Initialize Initializes this stream from two input streams. |
| IStreamConcatenate::Initialize2 Initializes this stream from an array of input streams. |
Remarks
To create the MsftStreamConcatenate object in a script, use IMAPI2.MsftStreamConcatenate as the program identifier when calling CreateObject.
When using this interface, the following scenarios will result in undefined behaviors, and should be avoided:
- Each partial stream composing the MsftStreamConcatenate object is actually the same stream.
- Any of the concatenated streams are modified (read from, written to, or seeked on) outside of IMAPI.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista, Windows XP with SP2 [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | imapi2.h |