IOpLockStatus Interface

This interface provides methods to check the opportunistic lock that is used by Microsoft Windows Desktop Search (WDS) on items while indexing. If another process locks the file in an incompatible manner, WDS will lose its lock and allow the other process to have the file. This mechanism allows WDS to run in the background. Consequently, WDS needs to check its locks to ensure another process has not taken precedence while WDS indexes the item.

A 3rd party IUrlAccessor object may implement this interface if the underlying data store provides a mechanism to track concurrent access to items. If this interface is exposed by IUrlAccessor, then WDS will check the IOpLockStatus while indexing items from that store.

IOpLockStatus Members

GetOplockEventHandle	Gets the event handle of the opportunistic lock (OpLock). The event object is set to the signaled state when the OpLock is broken, allowing the Indexer to stop all operations on the underlying IUrlAccessor object.
IsOplockBroken	Checks the status of the opportunistic lock (OpLock) on the item being indexed.
IsOplockValid	Checks the status of the opportunistic lock (OpLock) on the item being indexed.

Interface Information

Inherits from	IUnknown
Header and IDL files	searchapi.h, urlacc.idl
Minimum operating systems	Windows XP Service Pack 2 (SP2) with Windows Desktop Search (WDS) 3.0, Windows Server 2003, Windows Vista