Skip to content

Latest commit

 

History

History
86 lines (63 loc) · 3.39 KB

nf-objidl-irunnableobject-lockrunning.md

File metadata and controls

86 lines (63 loc) · 3.39 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:objidl.IRunnableObject.LockRunning
IRunnableObject::LockRunning (objidl.h)
Locks an already running object into its running state or unlocks it from its running state. (IRunnableObject.LockRunning)
IRunnableObject interface [COM]
LockRunning method
IRunnableObject.LockRunning
IRunnableObject::LockRunning
LockRunning
LockRunning method [COM]
LockRunning method [COM]
IRunnableObject interface
_com_irunnableobject_lockrunning
com.irunnableobject_lockrunning
objidl/IRunnableObject::LockRunning
com\irunnableobject_lockrunning.htm
com
ce501785-16ad-4120-abea-41e2d6ca67df
12/05/2018
IRunnableObject interface [COM],LockRunning method, IRunnableObject.LockRunning, IRunnableObject::LockRunning, LockRunning, LockRunning method [COM], LockRunning method [COM],IRunnableObject interface, _com_irunnableobject_lockrunning, com.irunnableobject_lockrunning, objidl/IRunnableObject::LockRunning
objidl.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
ObjIdl.idl
Windows
19H1
IRunnableObject::LockRunning
objidl/IRunnableObject::LockRunning
c++
APIRef
kbSyntax
COM
ObjIdl.h
IRunnableObject.LockRunning

IRunnableObject::LockRunning

-description

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

-parameters

-param fLock [in]

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

-param fLastUnlockCloses [in]

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.

-returns

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

-remarks

Most implementations of IRunnableObject::LockRunning call CoLockObjectExternal.

OleLockRunning is a helper function that conveniently repackages the functionality offered by IRunnableObject::LockRunning. With the release of OLE 2.01, the implementation of OleLockRunning was changed to call QueryInterface, ask for IRunnableObject, and then call IRunnableObject::LockRunning. In other words, you can use the interface and the helper function interchangeably.

-see-also

CoLockObjectExternal

IRunnableObject

OleLockRunning