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 MicroKernel 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

Set the Operation Code to 30.

Pass the Position Block that identifies the file to clear.

Result

After a Clear Owner operation, the MicroKernel 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 MicroKernel 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 MicroKernel returns one of the following status codes:


3	The file is not open.
41	The MicroKernel does not allow the attempted operation.

Positioning

The Clear Owner operation has no effect on any file currency information.