_BtSetOwner() Functions

<< Click to Display Table of Contents >>

Navigation:  Low Level Functions >

_BtSetOwner() Functions

Previous pageReturn to chapter overviewNext page

Purpose

 

 

Assign Owner name to Btrieve file

 

 

 

Prototype

 

 

FUNCTION _BtSetOwner(hFile AS PTR, cOwner AS STRING, nAccessMode AS BYTE) AS LOGIC

 

 

 

Argument(s)

 

 

<hFile>File handle that was returned by _BtOpen
<cOwner>New owner name for the table
<nAccessMode>Access mode for use without valid Owner name:
0        Requires an owner name for any access mode (no data encryption)
1        Permits read-only access without an owner name (no data encryption)
2        Requires an owner name for any access mode (with data encryption)
3        Permits read-only access without an owner name (with data encryption)

 

Description:

Please note that you can't set an owner name if there is already an owner name set for the table.

When SetOwner fails the Bt_Error() function may RETURN one of the following values:

41Operation Not Allowed
50 Owner Already Set
51 Invalid Owner

 

Return

 

 

LOGICWas the owner removed succesfully.

 

 

 

See Also

 

 

_BtClearOwner()