DocumentObj 2.5 CheckOutByIshLngRef
Checks out an object and locks it for other users.
Objects can only be checked out if:
- The user has write access for the object.
- No one else has checked out the object.
- The object is not part of a released publication.
Parameters
| Name | Type | Direction | Description |
|---|---|---|---|
| psAuthContext | String | InOut | Deprecated proprietary authentication context only used by .ASMX web services based on internal username/password authentication. Claims based security standards drive all the WCF .SVC web services, making this parameter redundant. |
| plLngRef | Long | In | The language level identifier. |
| psXMLRequiredCurrentMetadata | String | In | Metadata XML structure with the metadata that object is required to have set currently. The update of the object is only carried out when the object has exactly the same metadata specification, i.e. the metadata was not changed by someone else. |
| psXMLRequestedMetadata | String | In | Requested Metadata XML structure indicating which metadata has to be retrieved for a given object. |
| psOutXMLObjList | String | Out | ObjectList XML structure containing both the object content (base 64 encoded) and the requested metadata. |
Note that:
- The user name of the user who checked out the object is stored in the metadata field
CHECKED-OUT-BY. - If the object is already checked out by someone else, an exception will be thrown that contains the user name of the user that checked out the object.
- The result is no longer a byte stream with the requested object but an ObjectList containing both the object and its metadata. Like this metadata can also be returned for objects that are not XML and the returned metadata does not imply DTD modifications.
- Although an object is checked out, metadata changes are on the object are still allowed.