Microsoft SDK for Java

IStream Interface Fields

The IStream Interface contains the following fields.

iid The interface identifier.
LOCK_EXCLUSIVE Indicates a type of locking for the LockRegion and UnlockRegion methods. If this type of lock is granted, writing to the specified range of bytes is prohibited to everyone except for the owner, who was granted the lock.
LOCK_ONLYONCE Indicates a type of locking for the LockRegion and UnlockRegion methods. If this type of lock is granted, other LOCK_ONLYONCE locks cannot be obtained on the range.
LOCK_WRITE Indicates a type of locking for the LockRegion and UnlockRegion methods. If this type of lock is granted, the specified range of bytes can be opened and read any number of times. Writing to the locked range, however, is prohibited to everyone except the owner, who was granted the lock.
STATFLAG_DEFAULT Indicates that the name field should be included in the STATSTG structure returned by the Stat method.
STATFLAG_NONAME Indicates that the name field should not be included in the STATSTG structure returned by the Stat method.
STATFLAG_NOOPEN
STGC_DANGEROUSLYCOMMITMERELYTODISKCACHE Specifies that changes are committed to a write-behind disk cache, but that the cache is not saved to the disk.

Caution   The cache is eventually written to disk, but usually not until after the write operation has already returned. You risk losing data if a problem occurs before the cache is saved and the data in the cache is lost.

STGC_DEFAULT Specifies the default condition for the Commit method. This value indicates that none of the other values apply.
STGC_ONLYIFCURRENT Specifies that the commit operation occurs only if there have been no changes to the saved storage object since the user most recently opened the storage object. Prevents multiple users of a storage object from overwriting one another's changes.
STGC_OVERWRITE Specifies that the Commit method can overwrite existing data to reduce overall space requirements.

Caution   This value is not recommended for typical use because it is not as robust as the default case. Data loss can occur when the STGC_OVERWRITE value is specified and the commit operation fails due to some reason other than lack of space.

STREAM_SEEK_CUR Specifies that the origin of the offset in the Seek method is the location of the current seek pointer.
STREAM_SEEK_END Specifies that the origin of the offset in the Seek method is the end of the stream.
STREAM_SEEK_SET Specifies that the origin of the offset in the Seek method is the beginning of the stream.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.