Share via


ISequentialStream (Compact 2013)

3/26/2014

This interface supports simplified sequential access to stream objects. The IStream interface inherits its Read and Write methods from ISequentialStream.

When to Implement

You can implement ISequentialStream on an object if you require simple sequential access to a stream object. If you implement IStream, you must provide an implementation of the Read and Write methods from ISequentialStream.

Note

Most applications do not implement ISequentialStream as a separate interface, and you are not required to provide it separately even if you provide an IStream implementation.

Note

For example, the compound file implementation of structured storage does not succeed on a QueryInterface method for ISequentialStream but it includes the Read and Write methods through the IStream interface pointer.

When to Use

Call the methods of the ISequentialStream interface from a container or application to perform sequential read and write operations on data. Most applications call the Read and Write methods through the IStream interface.

Methods in Vtable Order

IUnknown method

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments the reference count.

Release

Decrements the reference count.

Method

Description

Read

Reads a specified number of bytes from the stream object into memory starting at the current seek pointer.

Write

Writes a specified number of bytes to the stream object starting at the current seek pointer.

Remarks

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header

objidl.h,
objidl.idl

Library

ole32.lib,
uuid.lib

See Also

Reference

COM Interfaces
IStream