Clear Owner (30)
The Clear Owner operation (B_CLEAR_OWNER) removes an owner name that you have previously assigned to a file with the Set Owner operation. If the file was previously encrypted, the transactional interface decrypts the file during a Clear Owner operation.
Parameters
Op Code
Pos Block
Data Buf
Data Buf Len
Key Buffer
Key Number
Sent
Returned
Prerequisites
•
The file must be open, and an owner name must have been specified.
•
No transactions can be active.
Procedure
1
Set the Operation Code to 30.
2
Pass the Position Block that identifies the file to clear.
Result
After a Clear Owner operation, the transactional interface no longer requires the owner name to open or modify a file. If you encrypted the data in the file when you assigned the owner, the transactional interface decrypts the data during a Clear Owner operation. The more data that was encrypted, the longer the Clear Owner operation takes.
If the Clear Owner operation is unsuccessful, the transactional interface returns one of the following status codes:
3
The file is not open.
41
The transactional interface does not allow the attempted operation.
Positioning
The Clear Owner operation has no effect on any file currency information.