OleLockRunning

Locks an already running object into its running state or unlocks it from its running state.

HRESULT OleLockRunning(

LPUNKNOWN pUnknown,	//Pointer to IUnknown interface
BOOL fLock,	//Flag indicating whether object is locked
BOOL fLastUnlockCloses	//Flag indicating whether to close object
);

Parameters

pUnknown

Points to an object's IUnknown interface in order to obtain a pointer to IRunnableObject::LockRunning.

fLock

TRUE locks the object into its running state. FALSE unlocks the object from its running state.

fLastUnlockCloses

TRUE specifies that if the connection being released is the last external lock on the object, the object should close. FALSE specifies that the object should remain open until closed by the user or another process.

Return Values

S_OK

Indicates that the object was successfully locked or unlocked.

E_OUTOFMEMORY

Out of memory.

E_INVALIDARG

Indicates one or more arguments are invalid .

E_UNEXPECTED

Indicates an unexpected error occurred.

Comments

The OleLockRunning function saves you the trouble of calling the IRunnableObject::LockRunning method. You can use OleLockRunning and IRunnableObject::LockRunning interchangeably. OleLockRunning queries for an IRunnableObject pointer. If successful, it returns the results of calling IRunnableObject::LockRunning.

Note The implementation of OleLockRunning in earlier versions of OLE differs from that described here.

For more information on using this function, see IRunnableObject::LockRunning.

See Also

CoLockObjectExternal, IRunnableObject::LockRunning, OleNoteObjectVisible

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples

Databases for Amazon shops developers

Amazon Categories Database
Browse Nodes Database