Btrieve API Guide (v11)

Clear Owner(30)

Clear Owner オペレーション(B_CLEAR_OWNER)では、あらかじめ Set Owner オペレーションを使ってファイルに割り当ててあるオーナー ネームを削除します。ファイルがあらかじめ暗号化されている場合は、Clear Owner オペレーションの実行中にトランザクショナル インターフェイスによってファイルの解読も行われます。

パラメーター

 
オペレーション コード
ポジション ブロック
データ バッファー
データ バッファー長
キー バッファー
キー番号
送り値

 
 
 
 
戻り値
 

 
 
 
 

前提条件

手順

  1. オペレーション コードに 30 を設定します。
  2. 対象となるファイルを識別するポジション ブロックを渡します。

結果

Clear Owner オペレーションが正常に実行されると、それ以降、トランザクショナル インターフェイスはファイルを開いたり変更したりするときにオーナー ネームを要求しなくなります。オーナーを割り当てるときにファイルのデータを暗号化した場合には、トランザクショナル インターフェイスは Clear Owner オペレーションの実行中にデータの解読も行います。暗号化されているデータが多いほど、Clear Owner オペレーションの実行にかかる時間は長くなります。

Clear Owner オペレーションが正常に実行されなかった場合は、トランザクショナル インターフェイスから次のステータス コードのいずれかが返されます。

3
ファイルが開いていません。
41
実行しようとした操作はトランザクショナル インターフェイスでは許可されていません。

ポジショニング

Clear Owner オペレーションは、ファイルのカレンシー情報にまったく影響しません。


Begin Transaction(19 または 1019)

Close(1)