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は、実行されません)
関連項目 -