dataStore.encryptionStatus( )

4D v18.4


dataStore.encryptionStatus () -> 戻り値

引数	型	説明
戻り値	オブジェクト	カレントデータストアと、それぞれのテーブルの暗号化についての情報

説明

dataStore.encryptionStatus( ) コマンドは、カレントのデータファイル(つまりds データストアのデータファイル)の暗号化状態を表すオブジェクトを返します。各テーブルについての状態も提供されます。

注:

他のデータファイルの暗号化状態を調べるためには、Data file encryption status コマンドを使用して下さい。
dataStore.encryptionStatus( ) メソッドは暗号化されたリモートデータストアから呼び出すことはできません。

戻り値

返されたオブジェクトには、以下のプロパティが格納されています:

プロパティ			型	詳細
isEncrypted			ブール	データファイルが暗号化されていればTrue
keyProvided			ブール	暗号化されたデータファイルに合致する暗号化キーが提供されていればTrue(*)
tables			オブジェクト	暗号化可能テーブルおよび暗号化されたテーブルと同じ数だけのプロパティを持つオブジェクト
	<table name>		オブジェクト	暗号化可能または暗号化されたテーブル
		name	テキスト	テーブル名
		num	数値	テーブル番号
		isEncryptable	ブール	テーブルがストラクチャーファイルで暗号化可能と宣言されていればTrue
		isEncrypted	ブール	テーブル内のレコードがデータファイル内で暗号化されていればTrue

(*) 暗号化キーは、以下の手段のどれかで提供されます:

dataStore.provideDataKey( ) コマンド
データストアを開く前に接続されていたデバイス
Discover data key コマンド

例題

カレントのデータファイル内で暗号化されているテーブルの数を知りたい場合を考えます:

 C_OBJECT($status)

 

 $status:=dataStore.encryptionStatus()

 

 If($status.isEncrypted) //データベースは暗号化されている

    C_LONGINT($vcount)

    C_TEXT($tabName)

    For each($tabName;$status.tables)

       If($status.tables[$tabName].isEncrypted)

          $vcount:=$vcount+1

       End if

    End for each

    ALERT(String($vcount)+" encrypted table(s) in this datastore.")

 Else

    ALERT("This database is not encrypted.")

 End if

参照

4D Blog - New 4D commands to work with encrypted data
Data file encryption status