バックアップメモリ(SRAM)内にある下記データを読み出し、パソコン内のファイルとして保存します。
保存されるファイル形式はファイリングデータの場合はバイナリ形式のファイル、それ以外のデータ の場合はCSV 形式のファイルです。
関数名
INT WINAPI EasyBackupDataRead(LPCSTR sSaveFileName,LPCSTR sNodeName,INT iBackupDataType,INT iSaveMode);
引数
sSaveFileName: (In)読み出したデータの保存先ファイルのファイルパス(文字列のポインタ)
sNodeName: (In)読み出すデータ元の参加局名(文字列のポインタ)
局名は「#WinGP」固定になります。
iBackupDataType: (In)読み出すデータの種類
|
値 |
データ種類 |
|---|---|
|
0x0001 |
ファイリングデータ |
|
0x0002 |
サンプリンググループ番号 1 のサンプリングデータ |
|
0x0003 |
サンプリンググループ番号1以外のすべてのサンプリンググループのデータ |
|
0x0004 |
|
|
0x0005 |
アラームブロック1 |
|
0x0006 |
アラームブロック2 |
|
0x0007 |
アラームブロック3 |
|
0x0008 |
アラームブロック4 |
|
0x0009 |
アラームブロック5 |
|
0x000A |
アラームブロック6 |
|
0x000B |
アラームブロック7 |
|
0x000C |
アラームブロック8 |
|
上記以外 |
(予約) |
データの種類がアラームブロック1 ～ 8の場合、1アラームブロック内にはGP-Pro EXの設定により最大アクティブデータ、ヒストリデータ、ログデータの3種類が格納されていますが、このAPIでは、以下の優先順位で有効なデータを持っているか確認し、あればそれを対象とします。
(1)アラームヒストリ
(2)アラームログ
(3)アラームアクティブ
どれも有効でなければエラーとなります。
iSaveMode: (In)保存方法
0:新規(同名のファイルがすでにある場合は、そのファイルを一旦削除し、上書きします。)
1:追加(ファイルの最後に追記する、まだそのファイルがない場合は、新規に作成します。)
上記以外:予約
戻り値
正常終了:0
異常終了:エラーコード
特記事項
アラームデータまたはサンプリングデータを読み出す場合、日付データは「yy/mm/dd」として扱われます。