dataStore.encryptionStatus( )

ホーム

4D v18

ランゲージリファレンス

ORDA - データストア

dataStore.encryptionStatus( )

説明

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

注: 他のデータファイルの暗号化状態を調べるためには、Data file encryption status コマンドを使用して下さい。

戻り値

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

プロパティ			型	詳細
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

参照

Data file encryption status