...
This web service renews an active lock that was acquired using PwsAcquireProjectorLocks. Locks are valid for a set amount of time (as a means of avoiding stale locks and the related problems). You can specify how long the lock is good for (up to 1 day) when acquiring the lock. If you have acquired a lock and intend to hold onto that lock for a significant amount of time (perhaps longer than the requested period of time), you should periodically invoke this service at an appropriate frequency to prevent your lock from expiring.
Request Format
| Panel | ||
|---|---|---|
| ||
|
Request Elements
Element | Data Type | Required? | Description | Sample Data |
|---|---|---|---|---|
Int32 | No | Click here for more information. | 1 | |
String | Yes | Click here for more information. | AX6DNTSsd7jKIwQw0/RKxw== | |
LockDurationSeconds | Int32 | Yes | The number of seconds the lock will be held |
. Must be between 1 second and 1 day (86400 seconds) |
. | 300 | |||
Int32 | Yes | The lock set to be renewed. Click here for more information. | 3839 |
Request Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/">
<soapenv:Header/>
<soapenv:Body>
<pws:PwsRenewProjectorLocks>
<pws:serviceRequest>
<req:RequestId>1</req:RequestId>
<req:SessionTicket>AX6DNTSsd7jKIwQw0/RKxw==</req:SessionTicket>
<req:LockDurationSeconds>300</req:LockDurationSeconds>
<req:ProjectorLockSetId>3839</req:ProjectorLockSetId>
</pws:serviceRequest>
</pws:PwsRenewProjectorLocks>
</soapenv:Body>
</soapenv:Envelope> |
...
| Panel | ||
|---|---|---|
| ||
|
Response Elements
Element | Data Type | Description | Sample Data |
|---|---|---|---|
Messages | The web service response status and message. Click here for more information. | ||
Int32 | Click here for more information. | 1 | |
Status | Click here for more information. | Ok | |
DateTime | Click here for more information. | 2018-11-01T20:33:46.6885921Z |
Response Usage Example(s)
...
- For all errors and warnings please refer to the Complete List of Errors and Warnings
ErrorNumber | ErrorCode | ErrorText |
|---|---|---|
| 50475 | SpecifiedLockNotFound | Invalid lock specified. |
| 50485 | CannotRenewLockReleased | Cannot renew lock because it has been released. |