Overview
This web service can be used to check the locked state of an entity or set of entities. It can also, optionally, steal any existing locks on the specified entity or entities. It can be used to determine whether your existing lock is still valid (has not expired and has not been stolen) – by specifying a Projector lock set id, or just to determine whether the specified entity or entities are already locked or not – by not specifying a Projector lock set id.
...
Element | Data Type | Required? | Description | |
|---|---|---|---|---|
Int32 | No | Click here for more information | 1 | |
String | Yes | Click /wiki/spaces/QA/pages/11796515 for more information | AXMhtleRqwAazB/BUJaCKA== | |
Locks | PwsProjectorLockRequest [1..100] | Yes | This structure contains the complete set of entities to check for existing locks. | |
Int32 | No | If you hold an existing lock set over these entities and want to verify that the lock set is still valid, specify the lock set id here. Otherwise leave this null or omit it. Note if you do hold a lock set and do not specify the lock set id here, the service will report that the entities are currently locked. Click here for more information | ||
LocksToSteal | PwsEntityLockSummary [1..100] | No | The detailed information of the locks that are to be stolen. If not specified, the request will fail if any requested locks are already held. If specified, the information supplied must exactly match the current state of existing locks or the attempt to steal the existing locks will fail. Typically, this service is invoked with LocksToSteal empty or null. If there are existing locks, they will be returned in the LockHolders member of PwsFault. This data can then be sent, as is, back to the server in a second invocation of this service, as LocksToSteal, if the caller desires to steal the locks. |
...