アクセス制御モードの変更

DmaBoolean ChangeACLMode(
  DmaInteger32           lACLMode)

アクセス制御機能付きで検索（edmSQL文）を実行するかどうかを示すアクセス制御モードを変更するメソッドです。

このメソッドで変更したモードは，CdbrEqlStatement::Executeメソッドのコール時に有効になります。

CdbrEqlStatement::Initializeメソッドがコールされていない状態でこのメソッドをコールするとエラーになります。また，戻り値がDMA_FALSEの場合，設定したアクセス制御モードは保証できません。

なお，アクセス制御モードの設定は，文書空間でアクセス制御機能を使用している場合だけ有効になります。

lACLMode（入力）

検索（edmSQL文）実行時のアクセス制御モードを指定します。

次のどちらかを指定してください。ただし，アクセス制御機能をサポートしていない文書空間の使用時にDBR_QUERY_WITH_ACLを指定した場合にはエラーになります。

• DBR_QUERY_WITH_ACL
  アクセス制御機能付き検索モードで実行します。このモードの場合，ユーザはアクセス権がないオブジェクトを検索結果として取得できません。
  
• DBR_QUERY_WITHOUT_ACL
  アクセス制御機能なし検索モードで実行します。このモードの場合，ユーザはアクセス権がないオブジェクトでも検索結果として取得できます。
  

DMA_TRUE 　正常終了

DMA_FALSE　異常終了

major_code	minor_code	説明	対処
ERR_DBR	ERR_ACCESSCONTROL_NOT_SUPPORTED	アクセス制御対応のデータベースを使用していません。	アクセス制御付き検索の実行モードを変更する場合は，アクセス制御対応のデータベースを使用してください。
ERR_DBR	ERR_EQL_NOT_INITIALIZE	初期化が実行されていません。	初期化を実行してください。
ERR_DMA	DMARC_BAD_PARAMETER	不正な引数が入力されました。	正しい引数を指定してください。
ERR_DMA	DMARC_NOT_SUPPORTED	このセッションまたはオブジェクトではサポートされていないメソッドです。 または，サポートされていないデータ型です。	この操作は実行できません。
ERR_DMA	DMARC_UNEXPECTED	予期しないエラーが発生しました。	処理を終了してください。