• 検索結果がありません。

4. システム API

4.1. システム設定

GetNETAPIVersion

目的 システムAPIの.NETライブラリバージョンを取得します。

書式 int GetNETAPIVersion(ref string dotNetVer);

引数 ref string dotNetVer

[out]バージョン情報を格納するためのバッファへのポインタを指定します。

C# コーディング例

int b1 = 0;

string buf = string.Empty;

b1 = Cipherlab.SystemAPI.Member.GetNETAPIVersion(ref buf);

VB コーディング例

Dim b1 As Integer Dim buf As String = “”

b1 = Cipherlab.SystemAPI.Member.GetNETAPIVersion(buf)

戻り値

戻り値 意味

0 正常終了

1 エラー終了

エラー終了時は、GetErrorCode()でエラーコードを取得します。

エラーコード 意味

4 ERROR_PARAMETER(パラメータに誤り)

補足 -

関連項目 -

GetHALUUID

目的 UUID(Universally Unique Identifier)を取得します。

書式 int GetHALUUID(ref Guid guid);

引数 ref Guid guid

[out]UUID情報を格納するためのバッファへのポインタを指定します。

C# コーディング例

int b1 = 0;

Guid guid = new Guid();

b1 = Cipherlab.SystemAPI.Member.GetHALUUID(ref guid);

VB コーディング例

Dim b1 As Integer Dim guid as new Guid

b1 = Cipherlab.SystemAPI.Member.GetHALUUID(guid)

戻り値

戻り値 意味

0 正常終了

1 エラー終了

エラー終了時は、GetErrorCode()でエラーコードを取得します。

エラーコード 意味

1 UUIDにアクセスできない

4 ERROR_PARAMETER(パラメータに誤り)

補足 UUIDは、オブジェクトを識別するための128ビット(16バイト)のユニークな値です。GUIDは、

Microsoftが提唱するUUID標準規格です。

関連項目 -

GetSysDevName

目的 デバイス名を取得します。

書式 int GetSysDevName(ref string deviceName);

引数 ref string deviceName

[out]デバイス名を格納するためのバッファへのポインタを指定します。

C# コーディング例

int b1 = 0;

string deviceName = string.Empty;

b1 = Cipherlab.SystemAPI.Member.GetSysDevName(ref deviceName);

VB コーディング例

Dim b1 As Integer

Dim deviceName As String = “”

b1 = Cipherlab.SystemAPI.Member.GetSysDevName(deviceName)

戻り値

戻り値 意味

0 正常終了

1 エラー終了

エラー終了時は、GetErrorCode()でエラーコードを取得します。

エラーコード 意味

2 ERROR_NOSPACE(バッファサイズに誤り) 4 ERROR_PARAMETER(パラメータに誤り)

補足 -

関連項目 -

SetSysDevName

目的 デバイス名を設定します。

書式 int SetSysDevName(string deviceName);

引数 string deviceName

[in]デバイス名を指定します。

C# コーディング例

int b1 = 0;

string setname = “9200”;

b1 = Cipherlab.SystemAPI.Member.SetSysDevName(setname);

VB コーディング例

Dim b1 As Integer

Dim setname as String = “9200”

b1 = Cipherlab.SystemAPI.Member.SetSysDevName(setname)

戻り値

戻り値 意味

0 正常終了

1 エラー終了

エラー終了時は、GetErrorCode()でエラーコードを取得します。

エラーコード 意味

1 ERROR_NORESOURCE(リソースの取得に失敗) 4 ERROR_PARAMETER(パラメータに誤り)

補足

ディフォルトでは、製造元がデイバス名を設定しています。

 新しいデバイス名を適用する場合は、ウォームブートを行ってください。

 デバイス名は、15文字以内で、下記のキャラクタが使用可能です。

a-z, A-Z, -, _ (先頭キャラクタは、a-z, A-Zでなければいけません)

関連項目 -

GetSysInfo

目的 システム情報(シリアル番号, デバイスコンフィグレーション, 製造日, OSバージョン)を取得します。

書式 int GetSysInfo(ref Sysinfo sysInfo);

引数 ref SysInfo sysInfo

[out]システム情報を格納するためのSysInfo構造体へのポインタを指定します。

C# コーディング例

int b1 = 0;

Cipherlab.SystemAPI.Member.SysInfo sysinfo = new Cipherlab.SystemAPI.Member.SysInfo();

b1 = Cipherlab.SystemAPI.Member.GetSysInfo(ref sysinfo);

VB コーディング例

Dim b1 As Integer

Dim sysinfo As New Member.SysInfo

b1 = Cipherlab.SystemAPI.Member.GetSysInfo(sysinfo)

戻り値

戻り値 意味

0 正常終了

1 エラー終了

エラー終了時は、GetErrorCode()でエラーコードを取得します。

エラーコード 意味

4 ERROR_PARAMETER(パラメータに誤り)

5 ERROR_API_FUNCTION(システムAPIコール失敗)

補足 -

関連項目 -

SetInitLoaderBind

目的 システム初期化後、ロードされるプログラムをバインドします。

書式 int SetInitLoaderBind(KeyPadBind keypadBind);

引数 KeyPadBind keypadBind

[in]プログラム情報を指定したKeyPadBind構造体へのポインタを指定します。

C# コーディング例

int b1 = 0;

Cipherlab.SystemAPI.Member.KeyPadBind keybind = new Cipherlab.SystemAPI.Member.KeyPadBind();

keybind.szClass = “¥¥DisckOnChip¥¥ImageMaker.exe”;

b1 = Cipherlab.SystemAPI.Member.SetInitLoaderBind(keybind);

VB コーディング例

Dim b1 As Integer

Dim keybind As New Member.KeyPadBind

keybind.szClass = “¥DisckOnChip¥ImageMaker.exe”

b1 = Cipherlab.SystemAPI.Member.SetInitLoaderBind(keybind)

戻り値

戻り値 意味

0 正常終了

1 エラー終了

エラー終了時は、GetErrorCode()でエラーコードを取得します。

エラーコード 意味

1 レジストリ登録失敗 2 レジストリ登録失敗

4 ERROR_PARAMETER(パラメータに誤り)

補足 バインドしたプログラムは、AutoRun.ini より前に実行され、AutoRun.exe を上書きま す。(AutoRun.exeは、実行されません)

関連項目 -

SystemSoftReset

目的 ソフトウェアリセット(ウォームブート)を実行します。

書式 int SystemSoftReset();

引数 無し

C# コーディング例 int b1 = 0;

b1 = Cipherlab.SystemAPI.Member.SystemSoftReset();

VB コーディング例 Dim b1 As Integer

b1 = Cipherlab.SystemAPI.Member.SystemSoftReset()

戻り値

戻り値 意味

0 正常終了

1 エラー終了

エラー終了時は、GetErrorCode()でエラーコードを取得します。

エラーコード 意味

1 ERROR_NORESOURCE(リソースの取得に失敗)

補足 バインドしたプログラムは、AutoRun.ini より前に実行され、AutoRun.exe を上書きま す。(AutoRun.exeは、実行されません)

関連項目 -

4.2. ステータスインディケータ