View source for WpUnlockObject

{{DISPLAYTITLE:wpUnlockObject}}
This instance method decrements an object's lock count.

==Syntax==
 _wpUnlockObject(somSelf)

==Parameters==
;''somSelf'' ([[WPObject]] *) - input
:Pointer to the object on which the method is being invoked.
:Points to an object of class WPObject.

==Returns==
;''rc'' ([[BOOL]]) - returns
:Success indicator.
::TRUE: Successful completion.
::FALSE: Error occurred.

==Remarks==
wpUnlockObject unlocks the specified object. When an object is unlocked, it automatically goes into the dormant state when it no longer has open views and its container is no longer open.

==Usage==
This method can be called at any time to decrement the object's lock count.
This method is used in conjunction with other methods that create new instances of objects. If these methods are called with the fLock flag set to TRUE, the new object is locked into the awake state until the wpUnlockObject method is called.

==How to Override==
This method is generally not overridden.

==Example Code==
<PRE>
#define INCL_WINWORKPLACE
#include <os2.h>

WPObject      *somSelf;       /* Pointer to the object on which the method is being invoked. */
BOOL          rc;             /* Success indicator. */

rc = _wpUnlockObject(somSelf);
</PRE>

==Related Methods==
* [[wpCopyObject]]
* [[wpQueryContent]]
* [[wpclsCreateDefaultTemplates]]
* [[wpclsNew]]

[[Category:Workplace Instance Methods]]