Export (0) Print
Expand All

IDirectWriterLock interface

The IDirectWriterLock interface enables a single writer to obtain exclusive write access to a root storage object opened in direct mode while allowing concurrent access by multiple readers. This single-writer, multiple-reader mode does not require the overhead of making a snapshot copy of the storage for the readers.

When to implement

Generally, you do not implement this interface unless you are defining a new storage scheme for your system. COM provides a compound file implementation of the IDirectWriterLock interface. For more information on the system-provided implementation, see IDirectWriterLock - Compound File Implementation.

When to use

Use this interface to obtain exclusive write access to a storage object in direct mode.

Call IDirectWriterLock::WaitForWriteAccess to obtain exclusive write access to the storage object. Call IDirectWriterLock::ReleaseWriteAccess to release exclusive write access.

IDirectWriterLock::HaveWriteAccess indicates whether the storage is currently locked.

Members

The IDirectWriterLock interface inherits from the IUnknown interface. IDirectWriterLock also has these types of members:

Methods

The IDirectWriterLock interface has these methods.

MethodDescription
HaveWriteAccess

Indicates whether the write lock has been taken.

ReleaseWriteAccess

Releases the write lock previously obtained.

WaitForWriteAccess

Obtains exclusive write access to a storage.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

Objidl.h

IDL

Objidl.idl

Library

Uuid.lib

DLL

Ole32.dll

IID

IID_IDirectWriterLock is defined as 0E6D4D92-6738-11CF-9608-00AA00680DB4

See also

IStorage
StgCreateDocfile

 

 

Community Additions

ADD
Show:
© 2014 Microsoft