ライセンス認証（アクティベーション）
実装ソリューション◆認証 Web サービス
◆認証管理アプリケーション◆配布アプリケーション用認証ライブラリ（DLL）

ユーザーズガイド（3.0.2）

- 目次 ●概要 ..................................................................................................................................................................................... 8●運用イメージ..................................................................................................................................................................... 9●認証レスキュー！で利用できるライセンスの種類.......................................................................................... 10●主な注目機能一覧 ..................................................................................................................................................... 11●インストールされる内容 ............................................................................................................................................ 12●動作環境 ........................................................................................................................................................................ 13●処理・設定一覧 ............................................................................................................................................................ 14●インストール................................................................................................................................................................... 15
1.「Web サーバー用 PC」へのインストール ........................................................................................................ 15
2.「認証業務用社内 PC」へのインストール ....................................................................................................... 17
3.「アプリケーション開発用 PC」へのインストール .......................................................................................... 18
4.インストールの終了後 ............................................................................................................................................ 18●Web サーバー用 PC と認証業務用社内 PC ..................................................................................................... 20
1.Web サーバー用 PC の「環境設定」処理........................................................................................................ 20◆必須設定処理項目 ........................................................................................................................................... 21■Web サービス/確認パスワード ................................................................................................................ 21■データベースの指定 .................................................................................................................................... 21■データテーブル新規作成 ........................................................................................................................... 22■「登録」ボタン .................................................................................................................................................. 24◆任意設定処理項目 ........................................................................................................................................... 26■ログイン設定................................................................................................................................................... 26■データベース更新 ......................................................................................................................................... 26■データベースコンバート .............................................................................................................................. 26■データベースのバックアップ ..................................................................................................................... 27■データベースの復元 .................................................................................................................................... 27
2.認証業務用社内 PC の「認証管理システム」 ............................................................................................... 28◆必須設定処理項目 ........................................................................................................................................... 29■環境設定 .......................................................................................................................................................... 29◇認証キーの作成 ............................................................................................................................................ 31■認証キー作成（自動ナンバリング） ................................................................................................... 31■認証キー作成（表形式） ........................................................................................................................ 35■認証キー作成（個別） ............................................................................................................................. 36■認証キー作成（ランダム生成） ............................................................................................................ 37■認証キー作成（インポート） .................................................................................................................. 38◆任意設定処理項目 ........................................................................................................................................... 39■認証キー編集（表形式） ............................................................................................................................. 39■認証キー削除（表形式） ............................................................................................................................. 41■認証キー削除（個別） .................................................................................................................................. 41■ラベル印刷 ...................................................................................................................................................... 42■認証状況 .......................................................................................................................................................... 44■ログの表示 ...................................................................................................................................................... 45■電話認証登録の対応.................................................................................................................................. 46■電話認証解除の対応.................................................................................................................................. 47◇オフライン（エンドユーザの PC が動作している場合） ............................................................... 47◇クラッシュ（エンドユーザの PC が動作不能になった場合） ..................................................... 49●有効期限機能の利用方法....................................................................................................................................... 50
1.貴社側作業① - 認証キー作成時に有効期限を設定する................................................................... 50
2.エンドユーザ側作業① - 認証登録を行う .................................................................................................. 50
3.貴社側作業② - 有効期限更新に備え、新しい有効期限を設定する.............................................. 51「認証レスキュー！.NET」 ユーザーズガイド-2-

4.エンドユーザ側作業② - 有効期限の更新を行う .................................................................................... 52◆Web アプリケーション（ASP.NET）から有効期限の更新を行う .............................................................. 54●フローティングライセンスの利用方法 .................................................................................................................. 55■貴社側作業 - 認証キー作成処理時にフローティングライセンスを設定する .............................. 55■エンドユーザ側作業 .............................................................................................................................................. 56
1.フローティングライセンス使用開始 .............................................................................................................. 56
2.フローティングライセンス使用終了 .............................................................................................................. 58●Microsoft Azure で認証レスキュー！を利用する方法 ................................................................................. 59■Microsoft Azure の仮想マシンを利用する ................................................................................................... 60
1.仮想マシンの作成 .............................................................................................................................................. 60
2.作成した仮想マシン ........................................................................................................................................... 62
3.仮想マシンのパブリック IP アドレスと DNS 名 ......................................................................................... 63
4.仮想マシンの受信セキュリティの規則の追加 ......................................................................................... 65
5.仮想マシンの開始 .............................................................................................................................................. 67
6.仮想マシンの接続 .............................................................................................................................................. 67
7.仮想マシンの日本語化の手順 ...................................................................................................................... 69
8.仮想マシンへの認証レスキュー！の Web サーバー用 PC のインストール ................................. 70
9.仮想マシンの Web サーバー用 PC の「環境設定」処理 ...................................................................... 71●Amazon AWS で認証レスキュー！を利用する方法 ....................................................................................... 72■Amazon AWS の仮想サーバーを利用する................................................................................................... 73
1.仮想サーバーの作成 ........................................................................................................................................ 73
2.固定グローバル IP アドレスと DNS 名の設定と割り当て .................................................................... 80
3.仮想サーバーの接続 ........................................................................................................................................ 84
4.仮想サーバーの日本語化の手順 ................................................................................................................ 89
5.仮想サーバーへの認証レスキュー！の Web サーバー用 PC のインストール ........................... 90
6.仮想サーバーの Web サーバー用 PC の「環境設定」処理 ................................................................ 91●アプリケーション開発用 PC での「認証 UI ライブラリ」の利用 ................................................................... 92■認証 UI ライブラリ関連ファイル ......................................................................................................................... 92■認証 UI ライブラリの利用形態による選択 .................................................................................................... 93■同一 PC 内で異なるアプリケーションやオプションのライセンスを識別する方法 .......................... 94■既定 UI 系サンプルプロジェクトとカスタム UI 系サンプルプロジェクトについて ............................. 96■ASP.NET 系サンプルプロジェクトについて................................................................................................... 96■DLL 及びサンプルフォルダのツリー図........................................................................................................... 97■認証 UI ライブラリ機能一覧 ............................................................................................................................... 98<クラス> ...................................................................................................................................................................... 98<既定 UI 系プロパティ> ........................................................................................................................................ 99
DisabledNICIgnore プロパティ .................................................................................................................... 100
EncryptionPassword プロパティ ................................................................................................................ 101
EncryptionSaltString プロパティ ............................................................................................................... 102
ProductIdNumberOfDigits プロパティ...................................................................................................... 103
SerialNoNumberOfDigits プロパティ ........................................................................................................ 104
SetProductID プロパティ.............................................................................................................................. 105
SetSerialNo プロパティ ................................................................................................................................. 106
TelephoneNumber プロパティ..................................................................................................................... 107
TrialPeriod プロパティ ................................................................................................................................... 108
TrialPeriodName プロパティ ........................................................................................................................ 109
UseCpuInfo プロパティ.................................................................................................................................. 110
UseMacAddress プロパティ ........................................................................................................................ 111
VendorsProductStartRegistryKeyPath プロパティ ............................................................................ 112
WebServiceBasicAuthenticationPassword プロパティ...................................................................... 113
WebServiceBasicAuthenticationUserName プロパティ .................................................................... 114「認証レスキュー！.NET」 ユーザーズガイド-3-

WebServiceCheckPassword プロパティ ................................................................................................. 115
WebServiceTimeout プロパティ ................................................................................................................. 116
WebServiceURL プロパティ......................................................................................................................... 117
WebServiceUseBasicAuthentication プロパティ ................................................................................. 118<既定 UI 系メソッド> ............................................................................................................................................ 119
ActivateRegisterInternet メソッド .............................................................................................................. 120
ActivateRegisterTelephone メソッド ......................................................................................................... 122
ActivateRemoveInternet メソッド .............................................................................................................. 123
ActivateRemoveTelephone メソッド ......................................................................................................... 125
ActivateStatusCheck メソッド .................................................................................................................... 126
ActivateStatusCheckOnline メソッド ........................................................................................................ 128
ActivateStatusDisp メソッド ........................................................................................................................ 130
ActivateStatusOnlineVerify メソッド......................................................................................................... 132
DeterminationOfProxyUpdateOfExpirationDate メソッド .................................................................. 133
FloatingLicenseFinish メソッド .................................................................................................................... 134
FloatingLicenseStart メソッド...................................................................................................................... 135
GetProxyUpdateOfExpirationDate メソッド............................................................................................ 137
PreparationOfProxyUpdateOfExpirationDate メソッド ....................................................................... 138
ProxyActivateRegisterExecute メソッド .................................................................................................. 139
ProxyActivateRegisterFix メソッド ............................................................................................................ 140
ProxyActivateRegisterPrepare メソッド .................................................................................................. 141
ProxyActivateRemoveExecute メソッド .................................................................................................. 142
ProxyActivateRemovePrepare メソッド................................................................................................... 143
RestoreCancelStatus メソッド .................................................................................................................... 144
RestoreRegisterStatus メソッド ................................................................................................................. 145
RunNR2AppDateRemove メソッド ............................................................................................................. 146
TrialStartDateRemove メソッド .................................................................................................................. 147
UpdateOfExpirationDate メソッド............................................................................................................... 148<カスタム UI 系プロパティ> ............................................................................................................................... 149
APIError 列挙体.............................................................................................................................................. 151
APICertificationID プロパティ..................................................................................................................... 178
APICurrentExpirationDate プロパティ..................................................................................................... 179
APIDisabledNICIgnore プロパティ ............................................................................................................. 180
APIEncryptionPassword プロパティ ......................................................................................................... 181
APIEncryptionSaltString プロパティ ........................................................................................................ 182
APIErrorStatus プロパティ .......................................................................................................................... 183
APIExternalLinkKey プロパティ ................................................................................................................. 184
APINewExpirationDate プロパティ............................................................................................................ 185
APIFloatingLicenseDataInfo プロパティ ................................................................................................. 186
APIFloatingLicenseMaxCount プロパティ .............................................................................................. 187
APIFloatingLicenseState プロパティ ....................................................................................................... 188
APIFloatingLicenseUsedCount プロパティ ............................................................................................ 189
APIFreeItem1～5 プロパティ ....................................................................................................................... 190
APILicenseKey プロパティ........................................................................................................................... 191
APIOverwriteModeOfExpirationDateUpdate プロパティ .................................................................. 192
APIProductID プロパティ ............................................................................................................................. 193
APIProductIdSerialNoList プロパティ ....................................................................................................... 194
APIProxyDataPath プロパティ ................................................................................................................... 195
APIProxyServerAddress プロパティ ........................................................................................................ 196
APIProxyServerPassword プロパティ ..................................................................................................... 197
APIProxyServerPort プロパティ ................................................................................................................ 198「認証レスキュー！.NET」 ユーザーズガイド-4-

APIProxyServerUserName プロパティ .................................................................................................... 199
APIReleaseKey プロパティ .......................................................................................................................... 200
APIReleaseStatus プロパティ..................................................................................................................... 201
APISelectRunAppDatePathFlag プロパティ .......................................................................................... 202
APISerialNo プロパティ ................................................................................................................................. 203
APITrialPeriod プロパティ ............................................................................................................................ 204
APIUseCpuInfo プロパティ .......................................................................................................................... 205
APIUseMacAddress プロパティ ................................................................................................................. 206
APIUseProxyServer プロパティ ................................................................................................................. 207
APIVendorsProductStartRegistryKeyPath プロパティ ..................................................................... 208
APIWebServiceBasicAuthenticationPassword プロパティ .............................................................. 209
APIWebServiceBasicAuthenticationUserName プロパティ ............................................................. 210
APIWebServiceCheckPassword プロパティ .......................................................................................... 211
APIWebServiceTimeout プロパティ .......................................................................................................... 212
APIWebServiceURL プロパティ ................................................................................................................. 213
APIWebServiceUseBasicAuthentication プロパティ .......................................................................... 214<カスタム UI 系メソッド> ..................................................................................................................................... 215
APIActivateRegisterInternet メソッド....................................................................................................... 217
APIActivateRegisterTelephone メソッド.................................................................................................. 220
APIActivateRemoveInternet メソッド ....................................................................................................... 223
APIActivateRemoveTelephone メソッド .................................................................................................. 226
APIActivateStatusCheck メソッド ............................................................................................................. 229
APIActivateStatusCheck2 メソッド ........................................................................................................... 231
APIActivateStatusCheckOnline メソッド................................................................................................. 233
APIActivateStatusCheckOnline2 メソッド .............................................................................................. 235
APIActivateStatusOnlineVerify メソッド ................................................................................................. 237
APIDeterminationOfProxyUpdateOfExpirationDate メソッド........................................................... 240
APIFloatingLicenseCancel メソッド ........................................................................................................... 243
APIFloatingLicenseFinish メソッド ............................................................................................................. 246
APIFloatingLicenseRegister メソッド ........................................................................................................ 249
APIFloatingLicenseStart メソッド .............................................................................................................. 252
APIGenerationOfNewCertificationID メソッド ....................................................................................... 255
APIGetFreeItem メソッド............................................................................................................................... 257
APIGetProductIdSerialNoList メソッド..................................................................................................... 259
APIGetProxyDataForExpirationDate メソッド ....................................................................................... 261
APIGetProxyDataForRegister メソッド .................................................................................................... 263
APIGetProxyDataForRemove メソッド..................................................................................................... 265
APIGetProxyUpdateOfExpirationDate メソッド .................................................................................... 267
APIGetRegisteredInfoFromRegistry メソッド......................................................................................... 270
APIGetRegisteredInfoFromRegistry2 メソッド ...................................................................................... 272
APIGetRegisteredInfoFromWeb メソッド ................................................................................................. 274
APIPreparationOfProxyUpdateOfExpirationDate メソッド................................................................ 277
APIProxyActivateRegisterExecute メソッド........................................................................................... 279
APIProxyActivateRegisterFix メソッド ..................................................................................................... 282
APIProxyActivateRegisterPrepare メソッド ........................................................................................... 285
APIProxyActivateRemoveExecute メソッド ........................................................................................... 287
APIProxyActivateRemovePrepare メソッド............................................................................................ 290
APIReadProxyServerInfoFromRegistry メソッド .................................................................................. 292
APIRestoreCancelStatus メソッド ............................................................................................................. 294
APIRestoreRegisterStatus メソッド .......................................................................................................... 297
APIRunNR2AppDateRemove メソッド ...................................................................................................... 299「認証レスキュー！.NET」 ユーザーズガイド-5-

APIRunNR2AppDateRemove2 メソッド .................................................................................................... 300
APITrialStartDateRemove メソッド ........................................................................................................... 301
APIUpdateOfExpirationDate メソッド ....................................................................................................... 302
APIWriteProxyServerInfoToRegistry メソッド ....................................................................................... 305<ASP.NET 系プロパティ>................................................................................................................................... 306
APIxError 列挙体 ........................................................................................................................................... 307
APIxDisabledNICIgnore プロパティ ............................................................................................................ 315
APIxErrorStatus プロパティ ......................................................................................................................... 316
APIxExpirationDate プロパティ ................................................................................................................... 317
APIxExternalLinkKey プロパティ ............................................................................................................... 318
APIxFreeItem1～5 プロパティ ..................................................................................................................... 319
APIxKindOfRandom プロパティ ................................................................................................................... 320
APIxLicenseCount プロパティ ..................................................................................................................... 321
APIxNumberingCount プロパティ ............................................................................................................... 322
APIxProductID プロパティ ............................................................................................................................ 323
APIxProxyServerAddress プロパティ ....................................................................................................... 324
APIxProxyServerPassword プロパティ .................................................................................................... 325
APIxProxyServerPort プロパティ ............................................................................................................... 326
APIxProxyServerUserName プロパティ ................................................................................................... 327
APIxSerialNo プロパティ ................................................................................................................................ 328
APIxSerialNoString プロパティ................................................................................................................... 329
APIxStartNo プロパティ ................................................................................................................................. 330
APIxStartFixedString プロパティ................................................................................................................ 331
APIxStepNo プロパティ.................................................................................................................................. 332
APIxUseFloatingLicense プロパティ.......................................................................................................... 333
APIxUseProxyServer プロパティ ................................................................................................................ 334
APIxUseExpirationDate プロパティ ........................................................................................................... 335
APIxWebServiceBasicAuthenticationPassword プロパティ ............................................................. 336
APIxWebServiceBasicAuthenticationUserName プロパティ ............................................................ 337
APIxWebServiceCheckPassword プロパティ ......................................................................................... 338
APIxWebServiceTimeout プロパティ ......................................................................................................... 339
APIxWebServiceURL プロパティ ................................................................................................................ 340
APIxWebServiceUseBasicAuthentication プロパティ ......................................................................... 341<ASP.NET 系メソッド> ......................................................................................................................................... 342
APIxCreateNumberingActivationKey メソッド ....................................................................................... 343
APIxCreateOneActivationKey メソッド .................................................................................................... 345
APIxCreateRandomActivationKey メソッド ............................................................................................ 347
APIxDeleteActivationKey メソッド ............................................................................................................. 349
APIxEditOfExpirationDate メソッド............................................................................................................ 351
代理認証機能について ...................................................................................................................................... 353■認証 UI ライブラリの参照 .................................................................................................................................. 355
Visual Studio 2015（Visual Baisc 2015/C# 2015）の場合 ..................................................................... 355■認証 UI ライブラリ（DLL）を利用したコーディング <既定 UI 系の場合> .......................................... 356
Visual Baisc 2015 の場合 ................................................................................................................................. 356
C# 2015 の場合 .................................................................................................................................................... 363■認証 UI ライブラリ（DLL）の配布 ..................................................................................................................... 372●認証レスキュー！で使う主なテーブルの概要 ............................................................................................... 373＜認証キーテーブル＞ ........................................................................................................................................... 373＜認証データテーブル＞ ....................................................................................................................................... 373＜認証キーテーブル＞の「プラス許可数」項目の必要性 ......................................................................... 375＜認証ログテーブル＞............................................................................................................................................ 376「認証レスキュー！.NET」 ユーザーズガイド-6-

●アプリケーション難読化の必要性 ....................................................................................................................... 379「認証レスキュー！.NET」 ユーザーズガイド

-7-

●概要
「認証レスキュー！.NET（以降、認証レスキュー！）」は、貴社のパッケージアプリケーションにライセ
ンス認証（アクティベーション）機能を付加して運用するためのソリューションです。
認証レスキュー！では、次の 3 つのソリューションを提供します。
1.Web サーバー用 PC に対するソリューション
インストーラが SQL Server 2014 Express のインストールや認証レスキュー！用のデータベースの設定、IIS の設定を行い、認証 Web サービス、環境設定をインストールします。
稼働後は認証 Web サービスが常時動作し、インターネットを経由したお客様（エンドユーザ）PC 上の貴社アプリケーションからの認証処理のリクエストに自動的に応答します。
また、同様にインターネット経由で、貴社の認証業務用社内 PC での認証管理システムからの認証状況の確認や新しいパッケージ製品の認証キーの作成などのリクエストも処理します。
2.認証業務用社内 PC に対するソリューション
社内 PC で使用する「認証管理システム」をインストールします。認証管理システムでは出荷前製品の認証キーの作成やプロダクト ID やシリアル No.のラベル印刷、お客様（エンドユーザ）がイン
ターネット経由で認証登録した記録などを閲覧できます。
3.「アプリケーション開発用 PC」へのソリューション
アプリケーションに認証登録用 UI（ユーザインターフェース）の機能を付加するための認証 UI ライ
ブラリ（DLL）とサンプルプログラムをインストールします。この認証 UI ライブラリ（DLL）を利用することで貴社のアプリケーションにライセンス認証（アクティベーション）機能を簡単に実装することができます。
この「認証レスキュー！」を導入することで驚くほど早く確実に、貴社パッケージアプリケーションにライセンス認証機能を実装でき、ライセンス不正利用による損害を防止できます！

「認証レスキュー！.NET」 ユーザーズガイド-8-

●運用イメージ③：製品に含まれるもの②

アプリケーション開発用PC

認証業務用社内PC
DLL用サンプルプロジェクト
認証管理システム（Windowsアプリ）

認証UIライブラリ（DLL）+①
プロダクトID

ベンダー
アプリケーション

Webサーバー用PC（IIS+SQL Server）

シリアルNo.

開発

時動

作確
認

Web環境設定（Windowsアプリ）
認証Webサービス（Webアプリ）

+

時）

ベンダー
アプリケーション

認証

理
（代

証
インターネット
認
ット
ネ
ー
）
タ
証時
イン
認
話
（電

認証UIライブラリ（DLL）

（代理

認証

時）

プロダクトID
シリアルNo.

配布
パッケージ

④

⑤

代理認証情報エンドユーザPC

代理PC（代理認証時）

主な運用手順は次の通りです。具体的な手順は、後述します。（丸付き数字は上図の各 PC です。）
1.認証レスキュー！のインストールを行う①Web サーバー用 PC、②認証業務用社内 PC、③アプリケーション開発用 PC にそれぞれインス
トールを行います。
2.インストールしたアプリケーションを使用して必要な各設定を行う①Web サーバー用 PC と②認証業務用社内 PC で設定します。
3.インストールしたアプリケーションを使用して必要な各処理を行うパッケージソフト出荷のための認証キー（プロダクト ID やシリアル No.など）を作成し、プロダクト I
D とシリアル No.ラベル印刷を行います。②認証業務用社内 PC が対象です。
4.インストールした認証 UI ライブラリ（DLL）を利用し貴社アプリケーションに認証機能を実装する③アプリケーション開発用 PC が対象です。
5.貴社アプリケーションをお客様（エンドユーザ）へ配布する④エンドユーザ PC が対象です。上記 4 で完成した貴社アプリケーションと上記 3 で発行したプロ
ダクト ID とシリアル No.をお客様（エンドユーザ）へ配布します。
6.お客様（エンドユーザ）がライセンス認証を実行する④エンドユーザ PC または⑤（エンドユーザの）代理 PC で、お客様（エンドユーザ）が貴社アプリケーションの認証 UI を使用してライセンス認証を行い、その内容が貴社 Web サーバーなどの認証
レスキュー！用のデータベースに記録されます。
その内容は、②認証業務用社内 PC の「認証状況」処理などで確認できます。

「認証レスキュー！.NET」 ユーザーズガイド-9-

●認証レスキュー！で利用できるライセンスの種類
認証レスキュー！では、次表のライセンスを利用できます。
ライセンス
形態

ライセンス種類

ライセンス認証方法
インターネット 代理（オフライン）
認証
認証

PC 固定型

無期限
ライセンス
有効期限
ライセンス
フ ロ ー テ ィ フローティング
ング型
ライセンス

電話
認証

ライセンス期限
有効
無期限
期限

〇

〇

〇

〇

✖

〇

〇

✖

✖

〇

〇

✖

✖

〇

〇

「ライセンス形態」について
・PC 固定型
エンドユーザの PC１台ごとに登録が必要なライセンスです。エンドユーザは、登録したライセンスを解除することで他の PC に再度、登録することができます。また、5 ライセンスや 10 ライセンスといったマルチライセンスの登録も可能です。
・フローティング型
エンドユーザで貴社のアプリケーションを同時に使用できる最大の PC 台数を設定するライセン
スです。エンドユーザは、最大 PC 台数以内であればどの PC でも貴社のアプリケーションを使用できます。
このライセンスは、エンドユーザの PC が常時インターネットに接続できる環境が必要ですが、世界中のどこにある PC でも、同じフローティングライセンス内での利用が可能です。
後述の以下のリンクもご覧ください。
有効期限機能の利用方法
フローティングライセンスの利用方法「認証レスキュー！.NET」 ユーザーズガイド- 10 -

●主な注目機能一覧◆従来機能・エンドユーザのプロキシサーバー環境に対応
・PC クラッシュ時の認証解除機能
・オフライン時電話認証機能
・認証 UI ライブラリ（DLL）の提供
・Web サービス用「環境設定」アプリの提供
・認証業務用「認証管理システム」アプリの提供
・Microsoft クラウド Azure 対応
・Amazon クラウド AWS 対応
・代理認証機能・試用期間機能・有効期限機能・プロダクト ID 桁数自由設定機能
・シリアル No.桁数自由設定機能
・MAC アドレス識別情報付加
・CPU 情報識別情報付加
・認証状況の Excel データ出力
・ログ表示の Excel データ出力
・認証状態オンライン確認機能
・認証状況およびログにエンドユーザの IP アドレスを記録◆拡張機能
・フローティングライセンス機能
・認証状況およびログにエンドユーザの PC 名を記録
◆便利機能
・各種データ閲覧時の検索条件設定機能
・認証キー自動ナンバリング機能
・認証キー一覧編集機能
・データベースのバックアップ（スケジュール化可）および、復元機能
・サンプルデータベース切替お試し機能
・DLL 用サンプルプロジェクトの提供◆セキュリティ関連
・環境設定でのログインダイアログ指定機能
・DLL での貴社独自の暗号化情報設定機能（認証レスキュー！を利用した他社とは別の暗号化）
・DLL はアセンブリ署名により偽装対策済み
・DLL は逆コンパイル対策の難読化済み
・SQL Server の SQL インジェクション対策済み（Web サービス）・Web サービスのブラウザ表示隠ぺい化「認証レスキュー！.NET」 ユーザーズガイド- 11 -

●インストールされる内容

Web サーバー用
PC・認証 Web サービス（Web アプリケーション）
・Web 環境設定（Windows アプリケーション）
・SQL Server 2014 Express + Management Studio

認証業務用 PC

・認証管理システム（Windows アプリケーション）

アプリケーション
開発用 PC・認証 UI ライブラリ（DLL）
・サンプルプロジェクト（既定 UI 系サンプル、カスタム UI 系サン
プル、ASP.NET 系サンプル）.NET Framework 4.5（Visual Basic 2015 用、C# 2015 用）.NET6（Visual Basic 2022 用、C# 2022 用）

ユーザ
ーズガ
イドな
ど

「認証レスキュー！.NET」 ユーザーズガイド- 12 -

●動作環境・「Web サーバー用 PC」へのインストールが対応している OS
日本語 Microsoft Windows Server 2022/2019/2016/2012 R2/2012
日本語 Microsoft Windows 11(Home は除く)/10(Home は除く)/8.1(Pro 以上)/8(Pro 以上)※上記 Windows OS 上の対応暦：グレゴリオ暦（西暦）のみ
・「Web サーバー用 PC」へのインストールが対応している IIS
IIS 10.0/8.5/8.0
・「認証業務用社内 PC」へのインストールによる「認証管理システム」が対応している OS
日本語 Microsoft Windows Server 2022/2019/2016/2012 R2/2012
日本語 Microsoft Windows 11/10/8.1/8※上記 Windows OS 上の対応暦：グレゴリオ暦（西暦）のみ
・「アプリケーション開発用 PC」へのインストールによる「認証 UI ライブラリ（DLL）」が対応している OS
Microsoft Windows Server 2022/2019/2016/2012 R2/2012
Microsoft Windows 11/10/8.1/8[DLL による OS および暦対応表]
DLL【既定 UI 系、カスタム UI 系 DLL】
Newtone.NR.FW45.dll / Newtone.NR.NET6.dll
Windows
日本語版および英語版推奨
対応 OS
対応 OS 上 ・ChineseLunisolarCalendar/中国の太陰太陽暦の対応暦
・GregorianCalendar/グレゴリオ暦（西暦）・HebrewCalendar/ヘブライ暦
・HijriCalendar/回教暦
・JapaneseCalendar/和暦
・JapaneseLunisolarCalendar/日本の太陰太陽暦
・JulianCalendar/ユリウス暦
・KoreanCalendar/韓国暦
・KoreanLunisolarCalendar/韓国の太陰太陽暦
・PersianCalendar/ペルシャ暦
・TaiwanCalendar/台湾暦
・TaiwanLunisolarCalendar/台湾の太陰太陽暦
・ThaiBuddhistCalendar/タイ仏暦
・UmAlQuraCalendar/ウムアルクラ暦【ASP.NET 系 DLL】
Newtone.NR.ASPNET.dll
日本語版のみ・GregorianCalendar/グ
レゴリオ暦（西暦）のみ

・認証 UI ライブラリ（DLL）を利用するための開発環境（すべて日本語版のみ）
Visual Studio 2022/2019/2017/2015
・認証 UI ライブラリ（DLL）が動作する対応 Framework
・.NET Framework 4.8 / 4.7.2 / 4.7.1 / 4.7 / 4.6.2 / 4.6.1 / 4.6 / 4.5.2 / 4.5 1 / 4.5
・.NET 8/7/6.0「認証レスキュー！.NET」 ユーザーズガイド- 13 -

●処理・設定一覧
認証レスキュー！では運用に必要な各処理の他に、ライセンス認証に関連する細かな設定が指定できます。
認証レスキュー！で利用できる処理や設定の一覧を示します。
◆Web サーバー用 PC
・Web サービスの設定
・環境設定へのログイン設定
・データベースの指定
NRD 規定/NRD サンプルデータ/任意接続文字列（マイクロソフト社クラウド Microsoft Azure など）
・データテーブル新規作成処理
・データベース更新処理
・NR 登録ライセンスの管理
・データベースのバックアップ処理（スケジュール化可能）・データベースの復元◆認証業務用社内 PC 「認証管理システム」
・Web サービスのアクセス設定
・プロキシサーバーの設定
・環境設定へのログイン設定
・認証キー作成（自動ナンバリング）処理
・認証キー作成（表形式）処理
・認証キー作成（個別）処理
・認証キー編集処理
・認証キー削除（表形式）処理
・認証キー削除（個別）処理
・ラベル印刷処理
・認証状況の表示/出力処理
・ログの表示処理◆アプリケーション開発用 PC 「認証 UI ライブラリ（DLL）」の利用＜付属サンプルプロジェクト＞.NET Framework 4.5（Visual Basic 2015 用）：既定 UI 系サンプル、カスタム UI 系サンプル.NET6（Visual Basic 2022 用）：既定 UI 系サンプル、カスタム UI 系サンプル.NET Framework 4.5（C# 2015 用）：既定 UI 系サンプル、カスタム UI 系サンプル.NET6（C# 2022 用）：既定 UI 系サンプル、カスタム UI 系サンプル.NET Framework 4.5（Visual Basic 2015 用）：ASP.NET 系サンプル.NET Framework 4.5（C# 2015 用）：ASP.NET 系サンプル＜プロパティ＞および＜メソッド＞の各機能（既定 UI 系、カスタム UI 系、ASP.NET 系）「認証レスキュー！.NET」 ユーザーズガイド- 14 -

●インストール（パッケージの場合は）ディスク内のルートまたは（ダウンロードなどの場合は）解凍したフォルダにある「NRInstallMenu.exe」を実行してください。次のような画面が表示されます。

これは、認証レスキュー！のインストールメニューです。
3 つのインストールボタンがあり、インストール先の PC の役割がそれぞれ異なります。
取り急ぎ、認証レスキュー！の概要を確認するためや体験版でご利用の場合は、これらを同一のローカル PC にインストールしてお試しいただくこともできます。
1.「Web サーバー用 PC」へのインストール
Web サーバー（またはローカル PC）に SQL Server 2014 Express のインストールや認証レスキュー！用のデータベースの設定、IIS の設定、および認証 Web サービス、環境設定などのインストー
ルを行います。
なお、Microsoft クラウド Azure の仮想マシンや Amazon クラウド AWS の仮想サーバーを利用する場合は、後述の「Microsoft Azure で認証レスキュー！を利用する方法」、「Amazon AWS で認
証レスキュー！を利用する方法」をご覧ください。
このインストールを選択するとさらに次の Web インストーラの画面が表示されます。

「認証レスキュー！.NET」 ユーザーズガイド- 15 -

ここでは、「データベースのインストール」と「IIS 設定と Web サービスのインストール」を行います。
・データベースのインストール
認証レスキュー！用のデータベース（SQL Server Express 日本語版）のインストールを行います。また、認証レスキュー！用のインスタンスと（データを除く）データベースも作成します。既に同じバージョンの SQL Server Express がインストールされている場合は、認証レスキュー！に必要な設定だけを行います。
・IIS 設定と Web サービスのインストール
認証 Web サービスのインストールを行います。Internet Information Services (IIS) が有効になっている必要がありますが、通常は、認証レスキュー！のインストーラが自動的に IIS を有効にして、IIS の不足している機能も自動的にインストールします。
「IIS 設定と Web サービスのインストール」のフレーム内で有効になっているボタンを選択するとインストールが始まります。選択できるボタンが無い場合は、現在の OS が対応外の可能性がありますのでご確認ください。
インストールを開始して IIS の設定が済むと確認画面の表示後、次のような「Web サービスと環境設定」のインストーラが起動されます。

「認証レスキュー！.NET」 ユーザーズガイド- 16 -

この画面では、サイト、仮想ディレクトリ、アプリケーションプールを指定しますが、通常はデフォル
ト（初期設定）のままで「次へ」ボタンを押します。以降は画面の指示に従ってください。
2.「認証業務用社内 PC」へのインストール
社内 PC で使用する「認証管理システム」をインストールします。認証管理システムでは出荷前製品の認証キーの作成やお客様（エンドユーザ）がインターネット経由で認証登録した記録などを閲覧できます。

「認証レスキュー！.NET」 ユーザーズガイド- 17 -

インストールするには画面の指示に従ってください。
3.「アプリケーション開発用 PC」へのインストール
アプリケーションに認証登録用 UI の機能を付加するための認証 UI ライブラリ（DLL）とサンプルプ
ログラムをインストールします。

インストールするには画面の指示に従ってください。
4.インストールの終了後
すべてのセットアップが終了すると、デスクトップに「認証レスキュー！.NET Web 環境設定」へのショートカット、「認証レスキュー！.NET 認証管理システム」へのショートカット、「認証レスキュー！.NET
認証 UI ライブラリ」フォルダへのショートカット用アイコンがそれぞれ次のように作成されます。

また、プログラムメニュー（すべてのアプリ）には次のように「認証レスキュー！」が登録されます。
「認証レスキュー！.NET」 ユーザーズガイド- 18 -

アンインストールは、「プログラムと機能」または「プログラムの追加と削除」から行います。

SQL Server Express 2014 をアンインストールする場合は、「プログラムと機能」または「プログラムの追加と削除」で次の項目をアンインストールします。PC の環境によっては、項目が異なる場合があります。

「認証レスキュー！.NET」 ユーザーズガイド- 19 -

●Web サーバー用 PC と認証業務用社内 PC
インストールが終了したら、認証レスキュー！を利用する前の各種設定が必要です。
1.Web サーバー用 PC の「環境設定」処理
デスクトップ上の「認証レスキュー！.NET We 環境設定」へのショートカットを起動すると次の画面が表示されます。
この実行ファイルは、インストール先がデフォルトなら、<32bitOS の場合> C:\Program Files\Newtone\NRD\NRDWeb\WebAdmin.exe、<64bitOS の場合> C:\Program Files (x86)\Newtone\NRD\NRDWeb\WebAdmin.exe です。

「認証レスキュー！.NET」 ユーザーズガイド- 20 -

◆必須設定処理項目
ここでは、設定が必須で省略できない設定について説明します。
■Web サービス/確認パスワード

Web サービスを利用する場合の確認用のパスワードを設定します。
ここでは、Web サーバー側設定アプリケーション「認証 Web サービス」の環境設定処理の Web サービスの確認パスワードと同じものを設定します。
また、UI ライブラリ（DLL）利用時に次のプロパティにも同じ内容を設定する必要があります。
WebServiceCheckPassword（既定 UI 系利用時）
APIWebServiceCheckPassword（カスタム UI 系利用時）
APIxWebServiceCheckPassword（ASP.NET 系利用時）
確認パスワードは必須項目です、省略はできません。
8 文字以上で半角の次の文字が使用できます。
・大文字の英字（A～Z）
・小文字の英字（a～ｚ）
・数字（0～9）・記号（+-*/!#$%&()=\@<>?）■データベースの指定

認証レスキュー！で使用するデータベースを指定します。選択肢は 3 種類です。
NRD 規定認証レスキュー！での規定のデータベースです。
実際の運用には通常、この「NRD 規定」を選択します。
マイクロソフト社のクラウドサービス Microsoft Azure の仮想マシン(Windows Server 2022 など)を利用する場合も、この「NRD 規定」を指定します。
Microsft Azure の仮想マシンを利用する方法は、後述の Microsoft Azure で「認証レスキュー！」を利用する方法を参照してください。

「認証レスキュー！.NET」 ユーザーズガイド- 21 -

認証レスキュー！では、Web サーバー用 PC へのインストール時に SQL Server 2014 Expressのインストールを選択できます。SQL Server 2014 Express をインストールして認証レスキュー！
のインスタンス（Newtone）を作成し、NRD 規定のデータベース（NRD）を作成します。この段階では、データベース（NRD）にテーブル（データ）はまだありません。
後述の「テーブルデータ新規作成」を実行することで空のテーブルが作成されます。
NRD サンプルデータベース
認証レスキュー！のサンプル用のデータベースです。簡単なサンプルデータが各テーブルに既に格納されたデータベースです。取り急ぎ認証レスキュー！全体を把握したい場合などに選択します。
後述の「テーブルデータ新規作成」を実行することでテーブルが作成され、サンプルデータが格納されます。
任意接続文字列(Azure など)
Web サーバー用 PC とは異なる（データベース）サーバーなどに SQL Server が用意され、そこに認証レスキュー！用のデータベースを置く場合に選択します。
また、Web サーバー用 PC の SQL Server を利用するが、たとえばインスタンス名をデフォルトの「Newtone」から別のものに変更する場合などにもこの「任意接続文字列」を利用できます。
この任意接続文字列の使用時は、テキストボックスに正しい接続文字列を入力する必要があります。
上記の設定をしたら「データベース接続確認」ボタンを押して、データベースに接続できることを確認してください。
■データテーブル新規作成
次に、データベースのテーブルの新規作成をします。
環境設定で「データテーブル新規作成」ボタンを押します。
認証 Web サービスの環境設定で「データベースの指定」が「NRD 規定」の場合「認証レスキュー！.NET」 ユーザーズガイド- 22 -

「テーブルを新規作成」ボタンを押すとデータベース内にデータの無いテーブルが作成されます。
実際のプロダクト ID やシリアル No.を含むキーデータは、「認証管理システム」のメニューの「認証キー作成」（自動ナンバリング）処理などで作成します。
以下にプロダクト ID やシリアル No.を簡単に説明しています。
・プロダクト ID
プロダクト ID は、製品を表わす任意の文字列です。桁数は運用開始時に設定し、以降は変更できません。
桁数の初期値は 17 桁です。最大 23 桁です。
なお、データベースの選択で「NRD サンプルデータベース」をお試しいただく場合の桁数は 17 桁固定となり設定できません。
このプロダクト ID には、製品分類やバージョン、ライセンス数などを識別できる桁取りがあると管理しやすくなります。
たとえば、0000A-00002-00001 で製品 A のバージョン 2 の 1 ライセンスを、0000A-00002-00004
で製品 A のバージョン 2 の 4 ライセンスを、それぞれ示すように設定します。
プロダクト ID は、半角の次の文字が使用できます。
・大文字の英字（A～Z）
・小文字の英字（a～ｚ）
・数字（0～9）・記号（+-*/!#$%&()=\@<>?）
このプロダクト ID と「シリアル No.」で出荷時の一意の製品を示すキーとなります。
・シリアル No.
シリアル No.は、同一製品の識別連番を表わす文字列です。桁数は運用開始時に設定し、以降は変更できません。桁数の初期値は 8 桁です。最大 23 桁です。
なお、データベースの選択で「NRD サンプルデータベース」をお試しいただく場合の桁数は 8 桁固定となり設定できません。
「認証キー作成」（自動ナンバリング）処理では、任意の上位桁数の文字列を指定することができます。
たとえば、8 桁中、上位 3 桁を"ABC"と指定した場合は次のようなシリアル番号の自動作成が可能です。
ABC00001
ABC00002
ABC00003
ABC00004
・・・・・
シリアル No. は、半角の次の文字が使用できます。
・大文字の英字（A～Z）
・小文字の英字（a～ｚ）
・数字（0～9）・記号（+-*/!#$%&()=\@<>?）「プロダクト ID」とこのシリアル No.で出荷時の一意の製品を示すキーとなります。

「認証レスキュー！.NET」 ユーザーズガイド- 23 -

認証 Web サービスの環境設定で「データベースの指定」が「NRD サンプルデータベース」の場合「テーブルを新規作成」ボタンを押すとデータベース内にサンプルデータが入ったテーブルが作成されます。
■「登録」ボタン
環境設定が終了したら「登録」ボタンを押します。次のようなメッセージが表示されます。

ここで、「OK」ボタンを押すと、次のような「配置先の指定」ダイアログが表示されます。

環境設定で入力した情報の内、Web サービスの動作に必要な情報を Web サービス環境設定デー
タ（WebServEnv.wai）ファイルとして、この「配置先の指定」ダイアログで IIS の認証レスキュー！用の Web サービスが配置してあるフォルダにも出力します。通常は、自動的に（例：C:\inetpub\www「認証レスキュー！.NET」 ユーザーズガイド- 24 -

root\NRDWebService などの）適切な出力先が表示されますので、確認してそのまま「保存」ボタンを押します。
なお、環境設定で入力した情報で Web サービスの動作と関係しない情報は、Web サービス環境
設定データ（WebServEnv.wai）ファイルではなく、この「環境設定」を実行している PC のレジストリに記録されます。
「保存」ボタン押下後、登録に成功すると次のメッセージが表示されます。

「認証レスキュー！.NET」 ユーザーズガイド- 25 -

◆任意設定処理項目
ここでは、必要に応じて行う処理について説明します。
■ログイン設定

ここでは、この環境設定（認証 Web サービス）にログインを使って起動する場合のユー
ザ名とパスワードを登録します。これらの情報は忘れないようにご注意ください。
■データベース更新

この処理は、認証レスキュー！で使用するデータベースのデータ形式を最新の形式に更新します。更新しても現在のデータは、そのまま引き継がれます。既に最新の形式になっている場合は更新されません。
■データベースコンバート「認証レスキュー！.NET」 ユーザーズガイド- 26 -

この処理は、前製品「認証レスキュー！2」のデータベースを本製品「認証レスキュー！.NET」のデータベースに変換します。前製品「認証レスキュー！2」のユーザ様で、現在のデータベースを本製品「認証レスキュー！.NET」でそのまま使用したいお客様がご利用ください。
コンバート元とコンバート先のデータベースを指定して、「コンバートを実行」ボタンを押します。
なお、データベースコンバート後も前製品「認証レスキュー！2」のデータベースはそのまま残ります。
■データベースのバックアップ

この処理は、認証レスキュー！で使用するデータベースをバックアップします。
「バックアップ先ファイル」を指定して「バックアップ開始」ボタンを押すとすぐにバックアップが実行されます。定期的なバックアップを設定するには、「スケジュール化する」をチェックしてバックアッ
プする間隔を指定します。
■データベースの復元

この処理は、バックアップしてあるデータベースを復元します。
「復元元ファイル」を指定して「復元開始」ボタンを押すとすぐに復元がが実行されます。

「認証レスキュー！.NET」 ユーザーズガイド- 27 -

2.認証業務用社内 PC の「認証管理システム」
デスクトップ上の「認証レスキュー！.NET 認証管理システム」へのショートカットを起動すると次の画面が表示されます。
この実行ファイルは、インストール先がデフォルトなら、<32bitOS の場合> C:\Program Files\Newtone\NRD\NRDInsideSystem\InsideSystem.exe、<64bitOS の場合> C:\Program Files (x86)\Newtone\NRD\NRDInsideSystem\InsideSystem.exe
です。

「認証管理システム」のメニューが表示されますが、最初に行うのは「環境設定」処理です。初期状
態では他の処理は選択できません。

「認証レスキュー！.NET」 ユーザーズガイド- 28 -

◆必須設定処理項目
ここでは、設定が必須で省略できない設定について説明します。
■環境設定「環境設定」ボタンを押すと次のような画面が表示されます。

各項目について説明します。
・Web サービス/URL
認証に関するシステムを Web サービスとして提供する Web サーバーの URL を指定します。
以下にいつくか例を示します。
★自 PC のローカルホストの Web サーバー（IIS）にアクセスする場合：
http://localhost/NRDWebService/Service.asmx★自社 Web サーバー（IIS）にアクセスする場合：
例えば、URL は
http://www.newtone.co.jp/NRDWebService/Service.asmx
といったものになります。
この、「www.newtone.co.jp」部分が貴社の Web サイトになります。
★クラウドサービス Microsoft Azure の仮想マシン（IIS）を利用する場合：
例えば、URL は
http://172.207.72.171/NRDWebService/Service.asmxx
といったものになります。
この、「172.207.72.171」部分が、貴社の Azure ポータルの「仮想マシン」の「パブリック IP アドレス」に表示されているものとなります。
また、Azure ポータルの「仮想マシン」の「DNS 名」で指定することも可能です。
例えば、DNS 名が「nrvm3-2022-ip.japaneast.cloudapp.azure.com」の場合の URL は
http://nrvm3-2022-ip.japaneast.cloudapp.azure.com/NRDWebService/Service.asmxx
といったものになります。
「認証レスキュー！.NET」 ユーザーズガイド- 29 -

・Web サービス/確認パスワード
Web サービスを利用する場合の確認用のパスワードを設定します。ここでは、Web サーバー側設
定アプリケーション「認証 Web サービス」の環境設定処理の Web サービスの確認パスワードと同じものを設定します。
確認パスワードは必須項目です、省略はできません。
8 文字以上で半角の次の文字が使用できます。
・大文字の英字（A～Z）
・小文字の英字（a～ｚ）
・数字（0～9）・記号（+-*/!#$%&()=\@<>?）
・Web サービス/タイムアウト
Web サービスに接続して応答を待つ最大時間を秒単位で指定します。
初期値は 60 秒です。
・Web サービス/基本認証を使用する
Web サーバーで基本認証を使用する場合はチェックを入れます。
初期値は、未チェック（基本認証を使用しない）です。
Web サーバー（IIS）側で特定のアカウント（ユーザ名とパスワード）でアクセスできるフォルダにこの Web サービスが配置してある場合に使用できるセキュリティ設定です。
Web サーバーで基本認証を使用する一般的な手順は次の通りです。
1.サーバーPC 上でユーザの作成を行う。
この際のユーザ名とパスワードがそのまま基本認証に使われます。
2.基本認証を使用するフォルダのセキュリティ設定を行う。
フォルダのプロパティを開き、セキュリティタブで上記 1 のユーザ名を追加し、「読み取り」権限を付与します。
3.IIS でのセキュリティ設定
IIS で該当フォルダに対し「認証」の設定で「匿名認証」を無効にして「基本認証」を有効にします。
なお、Web サーバーでの基本認証の詳細につきましてはマイクロソフト社の関連ドキュメントをご覧ください。
・プロキシサーバーを使用する
インターネットへのアクセス環境としてプロキシサーバーを使用している場合は、チェックを入れて「アドレス」と「ポート」を、更に必要に応じて「ユーザ名」と「パスワード」をそれぞれ指定します。
Web サービスは HTTP 経由で利用されます。その際、環境によってはセキュリティ上の制限から、プロキシサーバーを経由してインターネットにアクセスしなければならない場合があります。
そういった場合、使用しているプロキシサーバーの情報を設定することで問題なくプロキシサー
バー経由で Web サーバーの Web サービスにアクセスすることができます。
ここまでの設定をしたら、「Web サービス接続確認」ボタンを押して、Web サービスに接続できることを確認してください。
・ログイン設定
認証管理システムを起動する際に、ログイン画面を表示する場合はチェックを入れて、「ユーザ名」と「パスワード」を指定します。
「環境設定」の各項目の入力が終わったら、「登録」ボタンを押して設定を保存します。設定内容は
この「環境設定」を実行している PC のレジストリに保存されます。

「認証レスキュー！.NET」 ユーザーズガイド- 30 -

◇認証キーの作成
次は、認証キーを作成します。
次の 5 種類の作成方法がありますが、どれを使用するかは任意ですが、少なくてもどれかの方法で認証キーを作成する必要があります。
・自動ナンバリング
・表形式
・個別
・ランダム生成・インポート以降で各処理を説明します。
■認証キー作成（自動ナンバリング）
ここでは自動ナンバリングで作成します。
「認証管理システム」のメニューで「認証キー作成（自動ナンバリング）」ボタンを押します。
次の画面が表示されます。

以下に各項目を説明します。
・プロダクト ID
プロダクト ID は、製品を表わす任意の文字列です。
桁数は運用開始時に設定し、以降は変更できません。
桁数の初期値は 17 桁です。
なお、データベースの選択で「NRD サンプルデータベース」をお試しいただく場合の桁数は 17 桁

「認証レスキュー！.NET」 ユーザーズガイド- 31 -

固定となり設定できません。
このプロダクト ID には、製品分類やバージョン、ライセンス数などを識別できる桁取りがあると管理しやすくなります。
たとえば、0000A-00002-00001 で製品 A のバージョン 2 の 1 ライセンスを、0000A-00002-00004
で製品 A のバージョン 2 の 4 ライセンスを、それぞれ示すように設定します。
プロダクト ID は、半角の次の文字が使用できます。
・大文字の英字（A～Z）
・小文字の英字（a～ｚ）
・数字（0～9）・記号（+-*/!#$%&()=\@<>?）
このプロダクト ID と「シリアル No.」で出荷時の一意の製品を示すキーとなります。
・シリアル No.
プシリアル No.は、同一製品の識別連番を表わす文字列です。
桁数は運用開始時に設定し、以降は変更できません。
桁数の初期値は 8 桁です。
なお、データベースの選択で「NRD サンプルデータベース」をお試しいただく場合の桁数は 8 桁固定となり設定できません。
シリアル No. は、半角の次の文字が使用できます。
・大文字の英字（A～Z）
・小文字の英字（a～ｚ）
・数字（0～9）・記号（+-*/!#$%&()=\@<>?）「プロダクト ID」とこのシリアル No.で出荷時の一意の製品を示すキーとなります。
・上位固定文字列
上位固定文字列は、シリアル No.において任意の上位桁数の文字列を指定する場合に指定します。
たとえば、8 桁中、上位 3 桁を"ABC"と指定した場合は次のようなシリアル番号の自動作成が可能です。
ABC00001
ABC00002
ABC00003
ABC00004
・・・・・
・開始番号
開始番号は、シリアル No.において連番を自動付番する場合の最初の数を指定します。「間隔（ステップ）数」や「ナンバリング数」とともにシリアル No.の自動付番時の必須項目です。
たとえば、8 桁中、上位 3 桁を"ABC"と指定し、開始番号を 1、間隔（ステップ）数を 2、ナンバリン
グ数を 5 とそれぞれ指定した場合、次のようなシリアル番号が自動作成されます。
ABC00001
ABC00003
ABC00005
ABC00007
ABC00009
・間隔（ステップ）数間隔（ステップ）数は、シリアル No.において連番を自動付番する場合の付番間隔を数で指定します。「開始番号」や「ナンバリング数」とともにシリアル No.の自動付番時の必須項目です。
たとえば、8 桁中、上位 3 桁を"ABC"と指定し、開始番号を 1、間隔（ステップ）数を 2、ナンバリン「認証レスキュー！.NET」 ユーザーズガイド- 32 -

グ数を 5 とそれぞれ指定した場合、次のようなシリアル番号が自動作成されます。
ABC00001
ABC00003
ABC00005
ABC00007
ABC00009
・ナンバリング数
ナンバリング数は、シリアル No.において自動付番で作成する（シリアル No.の）数を指定します。
「開始番号」や「間隔（ステップ）数」とともにシリアル No.の自動付番時の必須項目です。
たとえば、8 桁中、上位 3 桁を"ABC"と指定し、開始番号を 1、間隔（ステップ）数を 2、ナンバリン
グ数を 5 とそれぞれ指定した場合、次のようなシリアル番号が自動作成されます。
ABC00001
ABC00003
ABC00005
ABC00007
ABC00009
・ライセンス数ライセンス数は、製品のライセンス数を指定します。
たとえば、1 ライセンスなら 1、5 ライセンスなら 5 と指定します。「認証キー作成」（自動ナンバリング）処理でライセンス数を指定する場合、1 度に作成する自動付番内に異なるライセンスを指定することはできません。
ライセンス数は、「プロダクト ID」や「シリアル No.」などとともに認証キーテーブルの項目のひとつです。
・有効期限設定
製品の認証登録後、無期限で使用できるライセンスではなく、特定の有効期限まで使用可能とするライセンス形態にする場合はこの設定を行います。
有効期限後も継続して使用可能とする場合の有効期限の再設定は、認証管理システムの「認証キー編集（表形式）」処理を利用します
・フローティングライセンス
同時に使用できる PC の数を設定する場合に選択します。
例えば、「フローティングライセンス」にチェックを入れて、ライセンス数を 10 としたら、それは貴社のアプリケーションを同時に最大 10 台までの PC でエンドユーザが利用できるライセンスを指します。また、前項の有効期限設定との組み合わせも可能です。例えば、同時に最大 10 台までの PCで１年間、といったライセンスも作成できます。
上記の各項目を入力して、「作成」ボタンを押すと認証キーが作成されます。
「認証キー一覧」ボタンを押すと作成した認証キーの一覧が次のように表示されます。

「認証レスキュー！.NET」 ユーザーズガイド- 33 -

「認証レスキュー！.NET」 ユーザーズガイド- 34 -

■認証キー作成（表形式）

パッケージ出荷前に製品 1 本毎の認証キー情報を表形式で一度に複数作成できます。
「作成」ボタン：
表に入力された内容で、＜認証キーテーブル＞に追加します。
「認証キー一覧」ボタン：
登録されている＜認証キーテーブル＞の一覧を検索条件を指定して表示します。

「認証レスキュー！.NET」 ユーザーズガイド- 35 -

■認証キー作成（個別）パッケージ出荷前に製品 1 本毎の認証キー情報を作成します。
「作成」ボタン：
入力された内容で、＜認証キーテーブル＞に 1 レコード追加します。
「認証キー一覧」ボタン：
登録されている＜認証キーテーブル＞の一覧を検索条件を指定して表示します。

「認証レスキュー！.NET」 ユーザーズガイド- 36 -

■認証キー作成（ランダム生成）

パッケージ出荷前に製品の認証キー情報を指定した数だけランダムに自動生成します。
「上位固定文字列」の指定や「ランダム指定」の選択ができます。
「作成」ボタン：
入力された内容で、＜認証キーテーブル＞に追加します。
「認証キー一覧」ボタン：
登録されている＜認証キーテーブル＞の一覧を検索条件を指定して表示します。

「認証レスキュー！.NET」 ユーザーズガイド- 37 -

■認証キー作成（インポート）

パッケージ出荷前に、製品の認証キー情報をインポートして作成します。
PC にインストールされている Excel のバージョンによってインポートできるファイルが異なります (Excel2007 以上：.xlsx / Excel2003 以下：.xls)。
2 行目から読み込みます。列は 12 列で、
1 列目:プロダクト ID、2 列目:シリアル No.、3 列目:ライセンス数、4 列目:有効期限利用、5 列目:有効
期限、6 列目:フローティングライセンス、7 列目:リンク用キー、8 列目:自由入力項目 1、9 列目:自由入力項目 2、10 列目:自由入力項目 3、11 列目:自由入力項目 4、12 列目:自由入力項目 5 です。
複数のファイルを繰り返しインポートできますが、インポートした順に最下行に追加されます。
Excel のブックの 1 シート目のみがインポートの対象となります。
「参照」ボタン：
インポートするファイルを選択します。
「インポート」ボタン：
インポートを実行します。
「作成」ボタン：
インポートされた内容で、＜認証キーテーブル＞に追加します。
「認証キー一覧」ボタン：
登録されている＜認証キーテーブル＞の一覧を検索条件を指定して表示します。

「認証レスキュー！.NET」 ユーザーズガイド- 38 -

◆任意設定処理項目
ここでは、必要に応じて行う処理について説明します。
■認証キー編集（表形式）

既に存在する認証キーを表形式で編集します。
※ライセンス形態が有効期限形式の場合で、特定のプロダクト ID とシリアル No に新しい有効期限を設定する場合は、当処理を利用します。
「検索実行」ボタン：入力された検索条件で、＜認証キーテーブル＞の該当するレコードを表示します。
検索結果に対して表上で編集できます。
その際、既に（子データである）認証データが存在する認証キーの行や、入力不可項目はグレーで表示され編集はできません。
「登録」ボタン：
表に入力された内容で、＜認証キーテーブル＞を更新します。
「有効期限の一括設定」
現在表示されている表内の認証キーすべての「有効期限」を一括で同日に設定できます。
「Excel ファイル出力」ボタン：
現在の表示内容を Excel ファイル（.xlsx）として出力します。ボタンを押すと出力先を指定するダイアログが表示されます。「保存」ボタンを押します。
「認証レスキュー！.NET」 ユーザーズガイド- 39 -

出力した Excel ファイルを開くか選択します。

出力した Excel ファイルの例：「認証レスキュー！.NET」 ユーザーズガイド- 40 -

■認証キー削除（表形式）「検索実行」ボタン：入力された検索条件で、＜認証キーテーブル＞の該当するレコードを表示します。
検索結果に対して表上で削除する行を指定します。
「選択削除」ボタン：
現在選択されている行を削除します。複数行の選択も可能です。
「全行削除」ボタン：
検索結果として表示されている現在のデータをすべて削除します。
■認証キー削除（個別）「認証レスキュー！.NET」 ユーザーズガイド- 41 -

既存の認証キーを＜認証キーテーブル＞から削除します。
この際、入力した「プロダクト ID+シリアル No.」が（子データの）＜認証データテーブル＞に存在する
場合は、そのレコードも削除されます。
「削除」ボタン：
入力された内容の認証キーを削除します。
「認証キー一覧」ボタン：
登録されている＜認証キーテーブル＞の一覧を検索条件を指定して表示します。
■ラベル印刷
次に、お客様（エンドユーザ）にアプリケーションを配布するために、前工程で作成した認証キーからプロダクト ID とシリアル No.のラベルシールを印刷します。
「認証管理システム」のメニューで「ラベル印刷」ボタンを押します。

ここでは、必要に応じて検索条件を入力して「検索実行」ボタンを押します。
表示された認証キーの一覧に対して印刷する対象にチェックをつけます。
「印刷プレビュー」ボタンを押すと次のような印刷プレビューが表示されます。

「認証レスキュー！.NET」 ユーザーズガイド- 42 -

ラベルシールは、このようにプロダクト ID とシリアル No. が横にそれぞれ 4 枚ずつ印刷されます。
その 1 行分にはすべて同じ内容が印刷されます。
奇数行目のプロダクト ID と次の行の偶数行目のシリアル No.で対となります。
同じラベルシールが 4 枚あるのは、それぞれの用途を想定しています。たとえば、次のような場合です。
1 枚目：パッケージ内の DVD ジャケット（ケース）添付（貼付）用
2 枚目：パッケージ内のユーザ登録用紙添付用
3 枚目：出荷指示書添付用
4 枚目：注文書控え添付用
・用紙の仕様このラベルシールの印刷用紙は、一般的な市販のラベルシール用紙を想定しています。
具体的には、次の仕様です。
用紙サイズ：A4
ラベル数：横 4×縦 9＝36 面
ラベルサイズ：45.7×25.4mm
余白：上 31.8mm/左 10.2mm/右 9.5mm/下 36.6mm
メーカ例：ヒサゴ 「A4 タックシール」 GB871 など「認証レスキュー！.NET」 ユーザーズガイド- 43 -

■認証状況

パッケージ出荷前に作成した認証キー情報（上表）と現在のエンドユーザによるライセンスの認証登録状況（下表）を表示します。
「検索実行」ボタン：入力された検索条件で、該当するデータを表示します。
「Excel ファイル出力」ボタン：
現在の表示内容を Excel ファイル（.xlsx）として出力します。

「認証レスキュー！.NET」 ユーザーズガイド- 44 -

■ログの表示

認証登録、認証解除、認証キー作成、認証キー削除時のログを表示します。また、ログの削除もできます。
「検索実行」ボタン：入力された検索条件で、該当するデータを表示します。
「ログの削除実行」ボタン：削除する条件を、「全削除」か「日付指定」から選択し、「日付指定」の場合はいつまでのログを削除
するかを年月で指定後、この「ログの削除実行」ボタンを押すと指定した条件のログデータが削除されます。
「Excel ファイル出力」ボタン：
現在の表示内容を Excel ファイル（.xlsx）として出力します。

出力した Excel ファイルを開くか選択します。

出力した Excel ファイルの例：「認証レスキュー！.NET」 ユーザーズガイド- 45 -

■電話認証登録の対応

エンドユーザ PC 上の画面

本処理（貴社の認証業務用 PC）の画面

エンドユーザがインターネットを使わずに電話でライセンス認証登録を依頼してきた場合の作業です。
上記の項目を電話でユーザから聞いて入力し、「登録」ボタンを押します。
その後、表示されたライセンスキーをエンドユーザに伝えて、エンドユーザ画面上の「ライセンスキーボックス」に入力してもらい「登録」ボタンを押してもらいます。
※上図のように貴社の認証業務用の PC とエンドユーザ用の PC の画面を並べて表示すると、ユー
ザとの電話対応がイメージできます。

「認証レスキュー！.NET」 ユーザーズガイド- 46 -

■電話認証解除の対応◇オフライン（エンドユーザの PC が動作している場合）
本処理（貴社の認証業務用 PC）の画面

エンドユーザ PC 上の画面

「認証レスキュー！.NET」 ユーザーズガイド- 47 -

エンドユーザがインターネットを使わずに電話でライセンス認証解除を依頼してきた場合の作業です。
上記の項目を電話でエンドユーザから聞いて入力し、「解除キーの表示」ボタンを押します。
その後、表示された解除キーをユーザに伝えて、エンドユーザ画面上の「解除キーボックス」に入力してもらい「解除」ボタンを押してもらいます。エンドユーザが正常に解除できたか確認したら社内用
PC 上の「解除」ボタンを押します。
「解除キー」、「解除ステータス」について
この解除キーと解除ステータスは、この処理でしか使用しません。また、データベースやエンドユー
ザ PC のレジストリにも保存しません。
解除キーはインターネット以外で認証解除をする場合に、必ず貴社に電話をかけさせるための手段として用意されています。
「電話認証解除の対応」の画面の「オフライン（ユーザの PC が動作している場合）」を見ると分かりますが、この解除キーの入力が無いとすると、「解除」ボタンを押すだけでエンドユーザが勝手に PC
上で認証解除ができてしまいます。この場合、エンドユーザ PC 上は認証解除状態になっても、貴社のデータベース上は認証解除にはなりません。情報のやり取りがないのですから当たり前です。そのままでは、再度エンドユーザが認証登録をしなおした場合に貴社のデータベースは解除されていないので登録は拒否されます。
そこでこのようなトラブルを避けるため、オフラインでの認証解除にはこの解除キーを必要とし、エンドユーザは貴社へ電話をして解除キーを聞かなければいけない仕組みになっているのです。
また、解除ステータスはエンドユーザがこの「電話で認証解除」を利用した不正ライセンスの流用防止のために使われます。

「認証レスキュー！.NET」 ユーザーズガイド- 48 -

◇クラッシュ（エンドユーザの PC が動作不能になった場合）

エンドユーザの PC がクラッシュしてしまい、OS などを入れなおした PC や別の PC に貴社のパッケ
ージを再インストールする場合で、そのために以前の認証解除をしなければいけない状況への対応処理です。
この場合、エンドユーザはパッケージに添付されているプロダクト ID とシリアル No.しか分かりません。
この処理では、上記の項目を電話でエンドユーザから聞いて入力後、「解除」ボタンを押します。
前述の「＜認証キーテーブル＞の「プラス許可数」項目の必要性」に書きましたが、この処理によりデータベースには新たに認証登録できる猶予が作成されます。

「認証レスキュー！.NET」 ユーザーズガイド- 49 -

●有効期限機能の利用方法
認証レスキュー！では、貴社がお客様（エンドユーザ）に対して通常の認証登録による無期限のライセンスとは別に、有効期限によるライセンスを設定することができます。
以下にその基本的な利用手順を示します。
1.貴社側作業①- 認証キー作成時に有効期限を設定する「認証管理システム」内の認証キー作成処理には、自動ナンバリング、表形式、個別、ランダム
生成、インポートの 5 種類があります。
これらの認証キー作成処理を使用して出荷前に最初の有効期限を設定します。
各処理の画面には指定したプロダクト ID とシリアル No.に対する「有効期限利用（する）」と「有効期限」の項目があります。
有効期限を設定するには、「有効期限利用（する）」をチェックして「有効期限」項目に有効期限としたい日付を設定します。
＜認証キー作成（個別）処理の画面例＞

上記の画面例では 5 ライセンス（マルチライセンス）に対して共通な有効期限を設定しています。
2.エンドユーザ側作業①- 認証登録を行う

エンドユーザに配布された貴社のアプリケーションから、通常の有効期限のない認証登録と同様に、認証 UI ライブラリ（DLL）を呼び出すことにより認証登録を実行してもらいます。
認証登録・解除の方法としてインターネットでの認証登録・解除、電話での認証登録・解除、代理
認証登録・解除の 3 種類がありますが、有効期限によるライセンスの場合は「電話での認証登録・解除」は利用できませんので、ご注意ください。
「認証レスキュー！.NET」 ユーザーズガイド- 50 -

＜「インターネットで認証登録」の画面例＞＜貴社のアプリケーションから「認証状況表示」を呼び出した場合の画面例＞
下図のように、貴社が出荷前に「認証管理システム」の「認証キー作成」処理で設定した有効期限がエンドユーザの PC にも設定されます。

3.貴社側作業②- 有効期限更新に備え、新しい有効期限を設定する

有効期限によるライセンスで使用していたエンドユーザの有効期限が迫ってきていて、貴社とエンドユーザの間で継続して使用するライセンスを更新する契約が合意されたとします。
その場合、貴社はエンドユーザが使用しているプロダクト ID とシリアル No.に対し新しい有効期限を設定する必要があります。
「認証管理システム」の「認証キー編集（表形式）」処理で新しい有効期限を設定します。

「認証レスキュー！.NET」 ユーザーズガイド- 51 -

＜認証キー編集（表形式）の画面例＞

上図の例では、プロダクト ID「12345-12345-12345」、シリアル No.「1234ABCD」のライセンスに対して、2024/03/31 までだった有効期限を、新しく 2025/03/31 までと、一年間更新しています。
この処理後は、貴社はエンドユーザに対し有効期限を延長したことを何らかの形で通知します。
4.エンドユーザ側作業②- 有効期限の更新を行う

エンドユーザは、貴社からの有効期限延長の通知を受け取ります。
次にエンドユーザに、貴社のアプリケーションから認証 UI ライブラリ（DLL）を呼び出すことにより「有効期限の更新」を実行してもらいます。
この処理は、エンドユーザ PC が有効期限による認証済みでない場合は、実行することはできません。
＜「有効期限の更新」の画面例＞
下図のように、プロダクト ID、シリアル No.、現在の有効期限が自動的に表示されます。
エンドユーザが「更新」ボタンを押すと、貴社が「認証管理システム」の「認証キー編集（表形式）」
処理で設定した新しい有効期限が「新しい有効期限」として表示されます。

「認証レスキュー！.NET」 ユーザーズガイド- 52 -

＜貴社のアプリケーションから「認証状況表示」を呼び出した場合の画面例＞
下図のように、新しい有効期限がエンドユーザの PC にも設定されます。

「認証レスキュー！.NET」 ユーザーズガイド- 53 -

◆Web アプリケーション（ASP.NET）から有効期限の更新を行う
ASP.NET（Web アプリケーション）用の DLL には Web ページから「有効期限の更新」を実行できる、A
PIxEditOfExpirationDate メソッドが用意されています。それを利用すれば、貴社が作成した Web ペ
ージの UI からエンドユーザに「有効期限の更新」を行わせることができます。
具体的な利用方法は、次の ASP.NET（Web アプリケーション）用のサンプルプロジェクトをご覧ください。
・SampleProject_Web フォルダ（ASP.NET 系サンプルプロジェクト）「認証レスキュー！.NET」 ユーザーズガイド- 54 -

●フローティングライセンスの利用方法
フローティングライセンスは貴社のアプリケーションを同時に使用できる最大の PC 台数を設定する
ライセンスです。
エンドユーザは、最大 PC 台数以内であればどの PC でも貴社のアプリケーションを使用できます。
このライセンス形態は、エンドユーザの PC が常時インターネットに接続できる環境が必要ですが、世界中のどこにある PC でも、同じフローティングライセンス内での利用が可能です。
以下にその基本的な利用手順を示します。
■貴社側作業- 認証キー作成処理時にフローティングライセンスを設定する「認証管理システム」内の認証キー作成処理には、自動ナンバリング、表形式、個別、ランダム
生成、インポートの 5 種類があります。
これらの認証キー作成処理を使用して出荷前にフローティングライセンスを設定します。
各処理の画面には「フローティングライセン」の項目があります。
フローティングライセンスを設定するには、「ライセンス数」を指定して「フローティングライセンス」
をチェックします。
＜認証キー作成（個別）処理の画面例＞

上記の画面例では 10 ライセンスのフローティングライセンスを設定しています。

「認証レスキュー！.NET」 ユーザーズガイド- 55 -

■エンドユーザ側作業
エンドユーザに配布された貴社のアプリケーションから、認証 UI ライブラリ（DLL）を呼び出すことによりエンドユーザに以下の処理を実行してもらいます。
エンドユーザ（お客様）側で行う、フローティングライセンスについては、次の 2 つの処理があります。
1.フローティングライセンス使用開始

貴社のアプリケーションの使用を開始する際に実行します。この処理を実行すると、フローティングライセンスを 1 ライセンス使用することになります。
最初の使用開始だけ、プロダクト ID とシリアル No.を入力します。
次回の使用開始からは必要な項目は自動的に表示されるので、「使用開始」ボタンを押すだ
けです。
貴社の設定ライセンス数以内で、正常にフローティングライセンスの使用が開始されると次のようなメッセージが表示されます。

この状態で、「認証状況オンライン表示」を実行すると次のように表示されます。

「認証レスキュー！.NET」 ユーザーズガイド- 56 -

上の画面例では 10 ライセンス中の（自分の PC を含む）2 ライセンスが使用されていることを表しています。

「認証レスキュー！.NET」 ユーザーズガイド- 57 -

2.フローティングライセンス使用終了

貴社のアプリケーションの使用を終了します。「使用終了」ボタンを押します。
その PC で使用を終了しないとフローティングライセンスを 1 ライセンス使ったままになりますので、注意が必要です。
次回、貴社のアプリケーションを使用するには再度、先の「使用開始」を実行します。
また、この PC のフローティングライセンスからの登録を解除する場合は「解除」ボタンを押します。この解除はこの PC でそのフローティングライセンスを使用する可能性がなくなった場合に実行してください。

「認証レスキュー！.NET」 ユーザーズガイド- 58 -

●Microsoft Azure で認証レスキュー！を利用する方法
ここでは、「認証レスキュー！」をマイクロソフト社のクラウドサービス Microsoft Azure で利用する方法について説明します。
「認証レスキュー！」を Microsoft Azure で利用するには、Azure の仮想マシンを利用します。
この仮想マシンを利用すると、オンプレミスの自社サーバーへのインストールとほぼ同様の手順で「認証レスキュー！」の利用開始ができます。

《参考》Azure の仮想マシンのコストの例 （2024/02/29 時点）
・構成例
場所：Japan East
インスタンス：
標準-B2s (2vcpu、4GB RAM) x 730 時間 (従量課金制)、Windows (ライセンス込み)、OS のみ
マネージド ディスク：E10（128GB、Standard SSD）
・1 ケ月あたりの平均コスト（小数点以下切り上げ）
仮想マシン：
6,727 円マネージドディスク： 1,418 円
合計：
8,145 円マイクロソフト社の Azure を使用するための推定時間単位または月単位のコストを計算する「料金計算ツール」の URL は次の通りです。
https://azure.microsoft.com/ja-jp/pricing/calculator/「認証レスキュー！.NET」 ユーザーズガイド- 59 -

■Microsoft Azure の仮想マシンを利用する
まず、貴社がマイクロソフト社に申込み、Microsoft Azure の「仮想マシン」機能が使用できる状態が必要です。Microsoft Azure の申込みなどにつきましては、マイクロソフト社の情報をご覧ください。
ここでは、貴社がすでに Microsoft Azure の「仮想マシン」を作成できる状態を前提としています。
1.仮想マシンの作成
次のマイクロソフト社のサイト「クイック スタート:Azure Portal で Windows 仮想マシンを作成する」も参考にされてください。
https://learn.microsoft.com/ja-jp/azure/virtual-machines/windows/quick-create-portal
以降は、Microsoft Azure のポータルサイトでの操作の例です。
「リソースの作成」で仮想マシンの作成を選択します。

「認証レスキュー！.NET」 ユーザーズガイド- 60 -

「仮想マシンの作成」で、必要事項を入力・選択して、「作成」ボタンを押します。
その際に、特段の理由がなければ、「地域」（仮想マシンの場所）項目は日本（Japan East/West）を選択することをお勧めします。例えば、デフォルトはアメリカ（米国東部など）となっていますが、日本からのアクセスだとやはり時間がかかります。

「認証レスキュー！.NET」 ユーザーズガイド- 61 -

2.作成した仮想マシン
作成した仮想マシンの「概要」です。

この中で、認証レスキュー！にとって重要な項目があります。
上図の赤枠で囲んだ「172.207.72.171」はパブリック IP アドレスです。これは、仮想マシンを作成すると自動的に割り当てられるパブリック（グローバル）IP アドレスです。これは、認証レスキュー！の認
証管理システムの「環境設定」や DLL のプロパティに設定してこの仮想マシンにアクセスするためのインターネット上の住所となります。

「認証レスキュー！.NET」 ユーザーズガイド- 62 -

3.仮想マシンのパブリック IP アドレスと DNS 名
前述のパブリック IP アドレス「172.207.72.171」は、下図のように Web サービスの URL の一部となります。
下図は認証管理システムの「環境設定」の例です。

なお、この URL に設定するのが、パブリック IP アドレスではなく、次のように仮想マシンの「DNS 名」で設定することもできます。
例えば次図のように、DNS 名が、「nrvm3-2022-ip.japaneast.cloudapp.azure.com」なら、URL は
http://nrvm3-2022-ip.japaneast.cloudapp.azure.com/NRDWebService/Service.asmxとなります。

「認証レスキュー！.NET」 ユーザーズガイド- 63 -

また。貴社で独自のドメインを割り当てることもできます。その場合は、貴社のドメインの DNS サー
バーにこの仮想マシンのパブリック IP アドレスを設定する必要があります。
また、http ではなく https の SSL サイトとしてアクセスさせる場合は、仮想マシンのＩＩＳに SSL サーバ
ー証明書をインストールする必要があります。

「認証レスキュー！.NET」 ユーザーズガイド- 64 -

4.仮想マシンの受信セキュリティの規則の追加

次に、仮想マシンに外部から認証レスキュー！の Web サービスに接続させるための設定を行います。
仮想マシンの「ネットワークセキュリティグループ」で左メニューの「受信セキュリティの規則」を選択します。

受信セキュリティの規則の画面で「+追加」を押します。

「認証レスキュー！.NET」 ユーザーズガイド- 65 -

次図のように項目を設定して「保存」ボタンを押します。
HTTPS

受信セキュリティの規則が追加されました。

これで、認証レスキュー！の Web サービスで使うためのポート 80（HTTP）が設定されました。
また、Web サービスの通信をポート 443（HTTPS）で行うこともできます。その場合、ここでの受信セ
キュリティの規則の追加のほかに、一般的には、仮想マシンの IIS で、あらかじめ取得した SSL サー
バー証明書をバインディングする必要があります。

「認証レスキュー！.NET」 ユーザーズガイド- 66 -

5.仮想マシンの開始
仮想マシンを開始します。「開始」を選択して、しばらく待ちます。
なお、通常は仮想マシンを、開始により起動している間はマイクロソフト社により課金されます。
初期のセットアップや動作確認などで使用する場合は適時、「停止」により仮想マシンを「停止済み(割り当て解除)」としておくのがよいでしょう。

6.仮想マシンの接続
仮想マシンに接続します。接続タブメニューの「接続」を選択します。

「認証レスキュー！.NET」 ユーザーズガイド- 67 -次に、ここでは、接続の方法として RDP（リモート デスクトップ）を選択します。

「RDP ファイルのダウンロード」をクリックして、次ののダイアログで開くアイコンを選択します。

次のダイアログで「接続」を選択します。

「認証レスキュー！.NET」 ユーザーズガイド- 68 -

次のダイアログで、仮想マシンの管理者ユーザー名のパスワードを入力して、「OK」を押します。。

仮想マシン（この場合、Windows Server 2022）のデスクトップが表示されます。

Azure の仮想マシンはデフォルトで英語（米国）ですが、上の画面は言語を日本語、タイムゾーンや時間など日本に設定した後のものです。
次の手順を参考にして、それらを日本語化にしてから、後述の「仮想マシンへの認証レスキュー！
の Web サーバー用 PC へのインストール」を行うことをお勧めします。
7.仮想マシンの日本語化の手順
Azure 仮想マシンの日本語化などの一般的な手順の例（Windows Server 2022）は、次の通りです。
(1) ログイン: Azure ポータルにログインします。
(2) 仮想マシンの選択: 左側のナビゲーションメニューから「仮想マシン」を選択し、設定を変更した
い仮想マシンを選択します。
(3) RDP 接続: 仮想マシンに RDP 経由で接続します。
(4) 言語と地域の設定:- スタートメニューを開き、「Settings（設定）」を選択します。
「認証レスキュー！.NET」 ユーザーズガイド- 69 -

- 「Time & Language（日時と言語）」をクリックします。
- 「Region」タブを選択し、表示されるリストから「Japan」を選択します。
(5) 日付と時刻の設定:- 「Date & Time（日付と時刻）」タブを選択します。
- 「Time zone（タイムゾーン）」で「(UTC+09:00) Osaka, Sapporo, Tokyo」を選択します。
(6) 言語の設定:- 「Language（言語）」タブを選択します。
- 「Preferred languages（優先言語）」をクリックし、「Add a language（言語を追加）」を選択します。
- 表示されるリストから「Japanese（日本語）」を選択し、「Next（次へ）」をクリックします。
- 「日本語 (日本) - [ja-JP]」を選択し、「Next（次へ）」をクリックします。
- オプションでデフォルトの表示言語を変更するかどうかを選択し、「Install（インストール）」をクリックします。
- その後、再起動が必要な場合は再起動します。
これで、仮想マシンの Windows Server 2022 の言語、地域、日付、および時間が日本や日本語に設定されます。
8.仮想マシンへの認証レスキュー！の Web サーバー用 PC のインストール
入手した認証レスキュー！がパッケージの場合は、ディスク内の全フォルダの全ファイル、ダウンロ
ードなどの場合は解凍したフォルダにある全フォルダの全ファイルを、仮想マシンの任意のフォルダにコピーしてください。全体で 1.3GB ほどありますので通信環境によっては時間がかかる場合があります。
次に、コピーしたルートフォルダにある「NRInstallMenu.exe」を実行してください
通常通り、認証レスキュー！のインストーラで「Web サーバー用 PC」へのインストールを行います。
以降の手順は、本操作ガイドの「インストール」の「Web サーバー用 PC へのインストール」と同様ですので、リンク先をご覧ください。
「Web サーバー用 PC へのインストール」が完了するとデスクトップに「認証レスキュー！ .NET Web
環境設定」のショートカットが表示されます。

これで、Microsoft Azure の仮想マシンへのインストールは終了です。

「認証レスキュー！.NET」 ユーザーズガイド- 70 -

9.仮想マシンの Web サーバー用 PC の「環境設定」処理
あとは、仮想マシン上の Web サーバー用 PC の「環境設定」を設定します。
詳しくは前述の Web サーバー用 PC の「環境設定」処理を参照してください。

「認証レスキュー！.NET」 ユーザーズガイド- 71 -

●Amazon AWS で認証レスキュー！を利用する方法
ここでは、「認証レスキュー！」をアマゾン社のクラウドサービス Amazon AWS で利用する方法について説明します。
「認証レスキュー！」を Amazon AWS で利用するには、AWS の EC2（仮想サーバー）を利用します。
この仮想サーバーを利用すると、オンプレミスの自社サーバーへのインストールとほぼ同様の手順
で「認証レスキュー！」の利用開始ができます。

《参考》AWS の EC2（仮想サーバー）のコストの例 （2024/09/06 時点）
・構成例
リージョン（場所）：アジアパシフッィク（東京）テナンシー (共有インスタンス)インスタンス数：1
オペレーティングシステム：Windows Server
EC2 インスタンス：t3a.medium、Family: t3a、2vCPU、4 GiB メモリ
EBS ストレージ量：(128 GB、汎用 SSD)
・1 ケ月あたりのコス合計：

48.21 USD

仮想マシン：
35.92 USD
マネージドディスク： 12.29 USD
合計：
48.21 USD （約 6,990 円） ※145 円/USD
アマゾン社の AWS を使用するための月単位のコストを計算する「AWS 料金見積りツール」の URLは次の通りです。
https://calculator.aws/#/addService?nc2=pr「認証レスキュー！.NET」 ユーザーズガイド- 72 -

■Amazon AWS の仮想サーバーを利用する
まず、貴社がアマゾン社に申込み、Amazon AWS の EC2（仮想マシン）が使用できる状態が必要です。Amazon AWS の申込みなどにつきましては、アマゾン社の情報をご覧ください。
ここでは、貴社がすでに Amazon AWS の EC2（仮想マシン）を作成できる状態を前提としています。
1.仮想サーバーの作成
次のアマゾン社のサイト「Amazon EC2 の使用を開始する」も参考にされてください。
https://docs.aws.amazon.com/ja_jp/AWSEC2/latest/UserGuide/EC2_GetStarted.html
以降は、Amazon EC2 コンソールでの操作の例です。
「EC2 ダッシュボード」で「インスタンスを起動」をクリックします。
その際に、特段の理由がなければ、「リージョン」（仮想サーバーの場所）項目は、アジアパシフィック(東京または大阪)を選択することをお勧めします。仮想サーバーを海外で指定すると、日本からのアクセスだとやはり時間がかかります。右上のリストでリージョンを指定できます。

「認証レスキュー！.NET」 ユーザーズガイド- 73 -

「Launch an instance」の「名前とタグ」で、任意の名前を入力します。

次に、「アプリケーションおよび OS イメージ (Amazon マシンイメージ)」で「Windows」を選択します。

「認証レスキュー！.NET」 ユーザーズガイド- 74 -

次に、「インスタンスタイプ」を選択します。
この例では、2vCPU、4GB メモリの「t2.medium」を指定しています。認証レスキュー！での使用では少なくともこのレベルをお勧めします。

次に、キーペア (ログイン)を作成します。「新しいキーペアの作成」をクリックします。

「認証レスキュー！.NET」 ユーザーズガイド- 75 -

次に、「キーペアを作成」画面が表示されますので、任意のキーペア名を入力して、「キーペアを作成」
をクリックします。

そうすると、ブラウザの「ダウンロード」に次のように履歴が表示されます。
このプライベートキーファイル（.pem）は後でインスタンスの接続時に使用しますので保存してください。

「認証レスキュー！.NET」 ユーザーズガイド- 76 -

次に、ネットワーク設定を行います。
「RDP トラフィックを許可」は、貴社の固定グローバル IP アドレスがあれば、自動的に表示されます
ので「自分の IP」に設定すると他の IP アドレスでは RDP（リモートデスクトップ）接続は不可となり、安全です。
さらに、「インターネットからの HTTPS トラフィックを許可」と「インターネットからの HTTP トラフィックを許可」にチェックを入れます。

「認証レスキュー！.NET」 ユーザーズガイド- 77 -

次に、ストレージを設定します。
例では、容量は 128GB を設定しています。

最後に、一番下までスクロールして、「インスタンスを起動」をクリックします。

「認証レスキュー！.NET」 ユーザーズガイド- 78 -Amazon EC2 コンソールの「インスタンス」の「インスタンス」を選択すると作成した仮想サーバーのインスタンスが表示されます。
そのインスタンス ID をクリックします。

作成した仮想サーバーのインスタンスの概要を確認できます。

「認証レスキュー！.NET」 ユーザーズガイド- 79 -

2.固定グローバル IP アドレスと DNS 名の設定と割り当て
ここでは、認証レスキュー！の認証管理システムの「環境設定」や DLL のプロパティに設定して利用することになる、仮想サーバーの固定グローバル IP アドレスや DNS の設定をします。
Amazon EC2 コンソールの「Elastic IP」を選択して、「Elastic IP アドレスを割り当てる」をクリックします。

Elastic IP アドレスを割り当てる画面の「Elastic IP アドレスの設定」の「パブリック IPv4 アドレスプール」が「Amazon の IPv4 アドレスプール」が選択されているのを確認します。

下までスクロールして、「割り当て」をクリックします。

「認証レスキュー！.NET」 ユーザーズガイド- 80 -

すると、次の画面が表示されますので引き続き、右上の「この Elastic IP アドレスを関連付ける」をク
リックします。

「Elastic IP アドレスの関連付け」の画面が表示されますので、「リソースタイプ」が「インスタンス」に選択されているのを確認します。さらに「インスタンス」が初期状態は空白になりますので、テキストボックスをクリックして表示されるリストから、先に作成したインスタンスを選択します。
最後に、下の「関連付ける」をクリックします。

「認証レスキュー！.NET」 ユーザーズガイド- 81 -

そうすると、Elastic IP アドレスの関連付けが終了して次のように表示されます。
この場合は、仮想サーバーの固定グローバル IP アドレスは、「54.150.131.249」で、DNS は「ec2-54-150-131-249.ap-northeast-1.compute.amazonaws.com」ということになります。
つまりこれが、認証レスキュー！の認証管理システムの「環境設定」や DLL のプロパティに設定して利用する仮想サーバーの固定グローバル IP アドレスや DNS となります。

「認証レスキュー！.NET」 ユーザーズガイド- 82 -

具体的には、この場合の認証レスキュー！の Web サービスの URL は、
http:// 54.150.131.249/NRDWebService/Service.asmx
または、
http:// ec2-54-150-131-249.ap-northeast-1.compute.amazonaws.com/NRDWebService/Service.asmxと設定することになります。
次が認証レスキュー！の認証管理システムの環境設定画面での例です。

また、この場合の認証レスキュー！の DLL の Web サービスの URL（ WebServiceURL プロパティ）
への設定は、次の通りとなります。（VB.NET）Class1.myActivate.WebServiceURL ="http://54.150.131.249/NRDWebService/Service.asmx"
またはClass1.myActivate.WebServiceURL ="http://ec2-54-150-131-249.ap-northeast-1.compute.amazonaws.com/NRDWebService/Service.asmx"

なお、貴社で独自のドメインを割り当てることもできます。その場合は、貴社のドメインの DNS サー
バーにこの仮想マシンのパブリック IP アドレスを設定する必要があります。
また、http ではなく https の SSL サイトとしてアクセスさせる場合は、仮想サーバーのＩＩＳに SSL サ
ーバー証明書をインストールする必要があります。

「認証レスキュー！.NET」 ユーザーズガイド- 83 -

3.仮想サーバーの接続
仮想サーバーに接続します。
Amazon EC2 コンソールの「インスタンス」の「インスタンス」で、該当するインスタンスチェックが入っている状態で、右上中央の「接続」をクリックします。

「インスタンスに接続」画面の、「RDP クライアント」タブを選択して、「パスワードを取得」をクリックします。

「認証レスキュー！.NET」 ユーザーズガイド- 84 -Windows パスワードを取得画面で、「プライベートキーファイルのアップロード」をクリックします。

ファイルダイアログが開くので、先の「キーペアを作成」時に保存したプライベートキーファイル（.pem）
を選択します。

「認証レスキュー！.NET」 ユーザーズガイド- 85 -

そうすると、Windows パスワードを取得画面の「プライベートキーの内容」のテキストボックスにプライ
ベートキーの内容が表示されます。
そこで、「パスワードを復号化」をクリックします。

インスタンスに接続画面にパスワードが表示されます。
Public DNS、パスワード、ユーザ名はそれぞれコピーボタンを使って、適切なファイルに保存しておいてください。RDP（リモートデスクトップ）のログイン時に使用します。

「認証レスキュー！.NET」 ユーザーズガイド- 86 -

「リモートデスクトップファイルのダウンロード」をクリックします。

ダウンロードしたファイル（.rdp）を実行します。

リモートデスクトップ接続のダイアログで「接続」をクリックします。

「認証レスキュー！.NET」 ユーザーズガイド- 87 -

資格情報入力で、パスワードを入力して「OK」を押します。パスワードは、先のインスタンス接続画面で表示されたものです。

リモートデスクトップ接続画面で、「はい」をクリックします。

「認証レスキュー！.NET」 ユーザーズガイド- 88 -

仮想サーバー（この場合、Windows Server 2022）のデスクトップが表示されます。

AWS EC2 仮想サーバーはデフォルトで英語（米国）ですが、次の手順を参考にして、それらを日本語化にしてから、後述の「仮想サーバーへの認証レスキュー！の Web サーバー用 PC のインストー
ル」を行うことをお勧めします。
4.仮想サーバーの日本語化の手順
AWS EC2 仮想サーバーの日本語化などの一般的な手順の例（Windows Server 2022）は、次の通りです。
(1) RDP（リモートデスクトップ）接続: 仮想サーバーに RDP 経由で接続します。
(2) 言語と地域の設定:- スタートメニューを開き、「Settings（設定）」を選択します。
- 「Time & Language（日時と言語）」をクリックします。
- 「Region」タブを選択し、表示されるリストから「Japan」を選択します。
(3) 日付と時刻の設定:- 「Date & Time（日付と時刻）」タブを選択します。
- 「Time zone（タイムゾーン）」で「(UTC+09:00) Osaka, Sapporo, Tokyo」を選択します。
(4) 言語の設定:- 「Language（言語）」タブを選択します。
- 「Preferred languages（優先言語）」をクリックし、「Add a language（言語を追加）」を選択します。
- 表示されるリストから「Japanese（日本語）」を選択し、「Next（次へ）」をクリックします。
- 「日本語 (日本) - [ja-JP]」を選択し、「Next（次へ）」をクリックします。
- オプションでデフォルトの表示言語を変更するかどうかを選択し、「Install（インストール）」をクリックします。
「認証レスキュー！.NET」 ユーザーズガイド- 89 -

- その後、再起動が必要な場合は再起動します。
これで、仮想サーバーの Windows Server 2022 の言語、地域、日付、および時間が日本や日本語に設定されます。
5.仮想サーバーへの認証レスキュー！の Web サーバー用 PC のインストール
入手した認証レスキュー！がパッケージの場合は、ディスク内の全フォルダの全ファイル、ダウンロ
ードなどの場合は解凍したフォルダにある全フォルダの全ファイルを、仮想マシンの任意のフォルダにコピーしてください。全体で 1.3GB ほどありますので通信環境によっては時間がかかる場合があります。
次に、コピーしたルートフォルダにある「NRInstallMenu.exe」を実行してください
通常通り、認証レスキュー！のインストーラで「Web サーバー用 PC」へのインストールを行います。
以降の手順は、本操作ガイドの「インストール」の「Web サーバー用 PC へのインストール」と同様ですので、リンク先をご覧ください。
「Web サーバー用 PC へのインストール」が完了するとデスクトップに「認証レスキュー！ .NET Web
環境設定」のショートカットが表示されます。

これで、AWS EC2 の仮想サーバーへのインストールは終了です。

「認証レスキュー！.NET」 ユーザーズガイド- 90 -

6.仮想サーバーの Web サーバー用 PC の「環境設定」処理
あとは、仮想サーバー上の Web サーバー用 PC の「環境設定」を設定します。
詳しくは前述の Web サーバー用 PC の「環境設定」処理を参照してください。

「認証レスキュー！.NET」 ユーザーズガイド- 91 -

●アプリケーション開発用 PC での「認証 UI ライブラリ」の利用■認証 UI ライブラリ関連ファイル
デスクトップ上の「認証レスキュー！ 認証 UI ライブラリ」へのショートカットを実行すると認証 UI ライ
ブラリが格納されている（インストール先がデフォルトの場合）次のフォルダが開きます。
<32bitOS の場合> C:\Program Files\Newtone\NRD\NRDDLL<64bitOS の場合> C:\Program Files (x86)\Newtone\NRD\NRDDLL
このフォルダに格納されているファイルは次の通りです。
フォルダ名
ファイル名/フォルダ名内容
NRDLL
Newtone.NR.ASPNET.dll
ASP.NET 系認証 UI ライブラリ（DLL）
Newtone.NR.FW45.dll
Framework4.5 用認証 UI ライブラリ（DLL）
Newtone.NR.NET6.dll.NET6 用認証 UI ライブラリ（DLL）
SampleProject
VisualBasic フォルダ
Visual Basic 用のサンプルプロジェクト（既定 UI 系サンプルプ CSharp フォルダ
C# 用のサンプルプロジェクト
ロジェクト）
または
SampleProject_API（カスタム UI 系サンプル
プロジェクト）SampleProject_Web
VisualBasic フォルダ
Visual Basic 用のサンプルプロジェクト（ASP.NET 系サンプル CSharp フォルダ
C# 用のサンプルプロジェクト
プロジェクト）
このライブラリを利用して、お客様（エンドユーザ）へ配布する貴社のアプリケーションにアクティベー
ション機能を組み込みます。
まずは、サンプルプロジェクトをお試しになり、ソースファイルをご確認ください。
なお、既定 UI 系機能とカスタム UI 系機能の利用形態の選択については次ページをご覧ください。

「認証レスキュー！.NET」 ユーザーズガイド- 92 -

■認証 UI ライブラリの利用形態による選択
既定 UI 系機能とカスタム UI 系機能の大きな違いは、既定 UI 系が認証レスキュー！の既定の UI（ユーザインターフェイス）を利用する前提であることに対し、カスタム UI 系は貴社オリジナルの UI を作成し利用できる点です。
たとえば、「認証登録/インターネット」処理を考えた場合、既定 UI 系では ActivateRegisterInternet
メソッドを呼び出すだけで、「認証登録/インターネット」処理の UI が表示され UI 上の項目の細かいプログラム的な制御などは全く必要ありません。
それに対し、カスタム UI 系では最終的には APIActivateRegisterInternet メソッドを呼び出しますが、UI にあたる Form のデザインや Form 上の項目に関する細かい制御や APIActivateRegisterInternet
メソッドを呼び出すための必須プロパティの設定などのコードを貴社で作成する必要があります。カスタム UI 系では各メソッド実行結果の細かいステータスは返しますが、メッセージの表示を含め一切の画面表示は行いません。
認証 UI ライブラリ（DLL）の利用形態によるメリットとデメリットは次表の通りです。
利用形態
メリット
デメリット
既定 UI 系機 ●認証レスキュー！既定の UI を利用 ●貴社オリジナルの UI を構築できないた能するため、貴社アプリケーションにア め、貴社アプリケーションとのシームレス
クティベーション機能を短期間で実装 な UI デザインや UI 上の（認証レスキュすることが可能ー！既定 UI には用意されていない）新規
項目などは利用できない●認証レスキュー！既定の UI を利用するため日本語のみの UI となる
カ ス タ ム U I ●貴社オリジナルの UI を構築できる ●貴社オリジナルの UI を構築するため
系機能ため、貴社アプリケーションとのシー 既定 UI 系に比べ、貴社アプリケーション
ムレスな UI デザインや UI 上の（認証 のアクティベーション機能実装に時間がレスキュー！既定 UI には用意されて かかるいない）新規項目などを作成できる
・貴社オリジナルの UI を構築できるため日本語以外の多言語の UI が作成
可能●プロダクト ID やシリアル No.を（レジストリより）取得できるメソッドがあるた
め、その文字列を定義することで、異なる製品や同一製品の追加オプショ
ンのライセンスを同一 PC 内で識別できる。
※次ページの（2）に例を掲載、既定 U
I 系にはそれらを取得する機能はない「認証レスキュー！.NET」 ユーザーズガイド- 93 -

■同一 PC 内で異なるアプリケーションやオプションのライセンスを識別する方法
2 つの方法があります。
（1） 同一 PC 内で貴社の異なるアプリケーションのライセンスを識別する場合
この方法は、同一 PC 内の異なるアプリケーションのライセンスの識別ができますが、同一アプリケーション内の異なるオプションなどについてはライセンスの識別はできません。
ベンダアプリケーション開始レジストリキーパス設定用のプロパティにアプリケーションごとに異なる
レジストリパスを設定します。
既定 UI 系：
VendorsProductStartRegistryKeyPath プロパティ
アプリケーションA内での設定コード例：
VendorsProductStartRegistryKeyPath = "Software\Company\A"
アプリケーションB内での設定コード例：
VendorsProductStartRegistryKeyPath = "Software\Company\B"
カスタム UI 系：
APIVendorsProductStartRegistryKeyPath プロパティ
アプリケーションA内での設定コード例：
APIVendorsProductStartRegistryKeyPath = "Software\Company\A"
アプリケーションB内での設定コード例：
APIVendorsProductStartRegistryKeyPath = "Software\Company\B"（2）同一 PC 内で貴社の異なるアプリケーションやオプションのライセンスを識別する場合
この方法は、同一 PC 内の同一アプリケーション内の異なるオプションについてもライセンスの識別ができます。この方法は、カスタム UI 系限定の機能を使用します。既定 UI 系では利用できません。
例えば、「プロダクト ID」9 桁とし先頭 4 桁をアプリケーションの製品コード、最後の 3 桁をオプション
コードとします。
[プロダクト ID の桁の定義]
1

2

3

4

5

製品コード

6

7

8

9

オプションコード[製品コードの定義]
0001：アプリケーション A
0002：アプリケーション B
0003：アプリケーション C
・・・・[オプションコードの定義]
オプションコード１桁目（プロダクト ID 7 桁目）：追加機能 1 がある場合 1、ない場合 0「認証レスキュー！.NET」 ユーザーズガイド- 94 -

オプションコード 2 桁目（プロダクト ID 8 桁目）：追加機能 2 がある場合 1、ない場合 0
オプションコード 3 桁目（プロダクト ID 9 桁目）：追加機能 3 がある場合 1、ない場合 0[貴社でのプログラム]
ライセンスを確認したいタイミングで APIGetRegisteredInfoFromRegistry メソッドを実行して、認証後のレジストリより「プロダクト ID」を取得します。その値の先頭の 4 桁の製品コードでアプリケーションを識別し、最後の 3 桁でオプションを識別できます。
例えば、取得したプロダクト ID が次の通りであれば
1

2

3

4

5

6

7

8

9

0

0

0

2

1

2

1

0

1

エンドユーザは、アプリケーション B の追加機能 1 と追加機能 3 のライセンスを保持していることになります。

「認証レスキュー！.NET」 ユーザーズガイド- 95 -

■既定 UI 系サンプルプロジェクトとカスタム UI 系サンプルプロジェクトについて
認証 UI ライブラリ（DLL）用のサンプルプロジェクトは次の 2 種類です。
・SampleProject フォルダ（既定 UI 系サンプルプロジェクト）・SampleProject_API フォルダ（カスタム UI 系サンプルプロジェクト）
これらのサンプルプロジェクトは、実際に実行してみると一見同じように見えますが、ソースコードを確認するとその相違点がわかります。
既定 UI 系サンプルプロジェクトが認証レスキュー！既定の UI を呼び出すサンプルプロジェクトになっているのに対し、カスタム UI 系サンプルプロジェクトでは UI 用の Form は全て貴社でカスタマイズ
可能です。
■ASP.NET 系サンプルプロジェクトについて利用できる ASP.NET（Web アプリケーション）用のサンプルプロジェクトは次の通りです。
・SampleProject_Web フォルダ（ASP.NET 系サンプルプロジェクト）
このサンプルプロジェクトは、ASP.NET で作成された貴社の Web ページから利用することができる、
ASP.NET 系の DLL の利用方法が含まれています。

「認証レスキュー！.NET」 ユーザーズガイド- 96 -

■DLL 及びサンプルフォルダのツリー図
フォルダ名の凡例は次の通りです。
分類
開発言語
サンプルプロジ
ェクトの種類
フレームワーク

凡例
CSharpVisualBasic
PackageApp
ProxyApp*.FW45*.NET6

説明C＃用VB.NET 用
下記「ProxyApp」を除いた認証機能のサンプルプロジェクト
代理認証のオフライン PC 側での操作のサンプルプロジェクト
Framewaork 4.5 用 （Vusual Studio 2015 用）.NET6 用 （Visual Studio 2022 用）├─NRDLL→ 認証 UI ライブラリ（DLL）の格納フォルダ├─SampleProject→ 既定 UI 系のサンプルフォルダ│ ├─CSharp│ │ ├─PackageApp│ │ │ ├─SamplePackageApp.FW45│ │ │ └─SamplePackageApp.NET6│ │ └─ProxyApp│ │├─SampleProxyApp.FW45│ │└─SampleProxyApp.NET6│ └─VisualBasic****VB.NET 用│├─PackageApp││ ├─SamplePackageApp.FW45││ └─SamplePackageAPP.NET6│└─ProxyApp│├─SampleProxyApp.FW45│└─SampleProxyApp.NET6├─SampleProject_API→ カスタム UI 系のサンプルフォルダ│ ├─CSharp│ │ ├─PackageApp│ │ │ ├─SamplePackageAppAPI.FW45│ │ │ └─SamplePackageAppAPI.NET6│ │ └─ProxyApp│ │├─SampleProxyAppAPI.FW45│ │└─SampleProxyAppAPI.NET6│ └─VisualBasic│├─PackageApp││ ├─SamplePackageAppAPI.FW45││ └─SamplePackageAppAPI.NET6│└─ProxyApp│├─SampleProxyAppAPI.FW45│└─SampleProxyAppAPI.NET6└─SampleProject_Web→ ASP.NET 系サンプルフォルダ （Vusual Studio 2015 用）├─CSharp│ └─WebApplication2└─VisualBasic└─WebApplication1「認証レスキュー！.NET」 ユーザーズガイド- 97 -

■認証 UI ライブラリ機能一覧【既定 UI 系、カスタム UI 系 DLL】●.NET Freamework4.5 用 DLL
アセンブリ：Newtone.NR.FW45 （Newtone.NR.FW45.dll 内）
名前空間：Newtone.NR.FW45●.NET6 用 DLL
アセンブリ：Newtone.NR.NET6 （Newtone.NR.NET6.dll 内）
名前空間：Newtone.NR.NET6【ASP.NET 系 DLL】
アセンブリ：Newtone.NR.ASPNET （Newtone.NR.ASPNET.dll 内）
名前空間：Newtone.NR.ASPNET
<クラス>
内容

クラス名

認証に関する各種機能の提供（既定 UI 系）
認証に関する各種機能の提供（カスタム UI 系）
認証に関する各種機能の提供（ASP.NET 系）

NRD_Activation
NRD_APIActivation
NRD_APIActivation2「認証レスキュー！.NET」 ユーザーズガイド- 98 -

<既定 UI 系プロパティ>
プロパティ一覧
プロパティ
DisabledNICIgnore

機能処 理 を 高 速 化 す る た め 、 無 効 に な っ て い る NIC（Network Interface Card）を無視します。
EncryptionPassword
暗号化時のパスワードを設定
EncryptionSaltString
暗号化時の Salt 文字列を設定
ProductIdNumberOfDigits
プロダクト ID の桁数を設定
SerialNoNumberOfDigits
シリアル No.の桁数を設定
SetProductID
認証登録時の設定プロダクト ID を設定
SetSerialNo
認証登録時の設定シリアル No.を設定
TelephoneNumber
電話で認証時の電話番号を設定
TrialPeriod
猶予（試用）日数を設定
TrialPeriodName
猶予（試用）期間の名称を設定
UseCpuInfo
CPU 情報の使用を設定
UseMacAddress
MAC アドレスの使用を設定
VendorsProductStartRegistryKeyPath
ベンダアプリケーション開始レジストリキーパスを設定
WebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワードを設定
WebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名を設定
WebServiceCheckPassword
Web サービス確認パスワードを設定
WebServiceTimeout
Web サービスのタイムアウトを設定
WebServiceURL
Web サービスの URL を設定
WebServiceUseBasicAuthentication
Web サービス時の基本認証の使用を設定「認証レスキュー！.NET」 ユーザーズガイド- 99 -

DisabledNICIgnore プロパティ【機能】
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
デフォルト：True。
【構文】<VB.NET>
Public Property DisabledNICIgnore As Boolean<C#>public bool DisabledNICIgnore { set; get; }【解説】
認証レスキュー！の認証 UI ライブラリでは、認証登録など各処理時にエンドユーザ PC の MAC アド
レスを最大で 5 個記録します。MAC アドレスは LAN ポートなどのネットワーク機器に固有な物理アドレスです。
このプロパティが False の場合、無効になっている NIC を一度有効にし、情報を取得後に再度 NICを無効にします。この際に少し時間が掛かります。
このプロパティを True に設定すると、この無効の NIC は無視し、有効の NIC のみ情報を取得して記録します。これにより、情報の取得が高速化します。
認証レスキュー！の各処理では、最初に認証状況を確認しており、認証済みの場合、記録されている情報と、使用されている PC 情報が合致しているか確認しています。
このプロパティを True に設定することで、各処理が高速化します。
＜ご注意＞
たとえば、エンドユーザ PC の NIC が 2 つ有効で 3 つが無効の状態とします。
ＭＡＣアドレスの例：①A11111111111 → NIC が有効②B22222222222 → NIC が有効③C33333333333 → NIC が無効④D44444444444 → NIC が無効⑤E55555555555 → NIC が無効
このプロパティが False の場合、5 個の MAC アドレスを取得するために、2 つ有効（①②）になっている MAC アドレスと、3 つの無効（③④⑤）の NIC を一度有効にし、MAC アドレスを取得後に再度無効に設定します。
この無効の NIC を有効にし、再度無効にすることで、少々時間が掛かります。
このプロパティが True の場合、この 3 つの無効の NIC は無視し、2 つの有効な MAC アドレスのみ取得します。これにより、ＭＡＣアドレスの取得時間が短縮されます。
しかし、次の点にご注意ください。
たとえば、このプロパティが True で、2 つの有効な（①②）になっている MAC アドレスで認証登録をします。
次に、2 つの有効な（①②）NIC を無効にし、3 つの無効な（③④⑤）を有効にして認証解除は、MAC
アドレスが一致しないため「-999：認証済みハードウエア情報不一致」となり実行できません。

「認証レスキュー！.NET」 ユーザーズガイド- 100 -

EncryptionPassword プロパティ【機能】
暗号化時のパスワードを設定します。
【構文】<VB.NET>
Public Property EncryptionPassword As String<C#>public string EncryptionPassword { set; get; }【解説】
認証 UI ライブラリ（DLL）はエンドユーザ PC のレジストリやファイルにデータを出力する際に必要に応じてデータを暗号化しています。その際の暗号化の方法は貴社では指定できませんが、暗号化する時の 2 つのパラメータ、パスワードと Salt 文字列は貴社で指定できます。
EncryptionPassword プロパティには暗号化時のパスワードを指定します。全角でも指定できます。
（例）"認証レスキュー！"この EncryptionPassword プロパティの文字数は、空文字列は不可で 1～65535 文字ですが、8 文字
から 15 文字程度が妥当と思われます。

「認証レスキュー！.NET」 ユーザーズガイド- 101 -

EncryptionSaltString プロパティ【機能】
暗号化時の Salt 文字列（8 文字以上）を設定します。
【構文】<VB.NET>
Public Property EncryptionSaltString As String<C#>public string EncryptionSaltString { set; get; }【解説】
認証 UI ライブラリ（DLL）はエンドユーザ PC のレジストリやファイルにデータを出力する際に必要に応じてデータを暗号化しています。その際の暗号化の方法は貴社では指定できませんが、暗号化する時の 2 つのパラメータ、パスワードと Salt 文字列は貴社で指定できます。
EncryptionSaltString プロパティには暗号化時の Salt 文字列を指定します。
必ず 8 文字以上で指定します。
（例）"12345678ABCDEFGH"「認証レスキュー！.NET」 ユーザーズガイド- 102 -

ProductIdNumberOfDigits プロパティ【機能】
プロダクト ID の桁数（デフォルト：17）を設定します。
【構文】<VB.NET>
Public Property ProductIdNumberOfDigits As Integer<C#>public int ProductIdNumberOfDigits { set; get; }【解説】
認証業務用社内 PC の「認証管理システム」の「データテーブル新規作成」処理時に指定したプロダ
クト ID の桁数を設定します。

「認証レスキュー！.NET」 ユーザーズガイド- 103 -

SerialNoNumberOfDigits プロパティ【機能】
シリアル No.の桁数（デフォルト：8）を設定します。
【構文】<VB.NET>
Public Property SerialNoNumberOfDigits As Integer<C#>public int SerialNoNumberOfDigits { set; get; }【解説】
認証業務用社内 PC の「認証管理システム」の「データテーブル新規作成」処理時に指定したシリア
ル No.の桁数を設定します。

「認証レスキュー！.NET」 ユーザーズガイド- 104 -

SetProductID プロパティ【機能】
認証登録時の設定プロダクト ID（デフォルト：空文字列）を設定します。
【構文】<VB.NET>
Public Property SetProductID As String<C#>public string SetProductID { set; get; }【解説】
このプロパティが空文字列の場合は、認証登録系のメソッドで表示されるダイアログのプロダクトID用のテキストボックスは、エンドユーザによる入力が可能となります。
このプロパティが空文字列ではない場合は、認証登録系のメソッドで表示されるダイアログ中のプロ
ダクトID用のテキストボックスにこのプロパティ値がグレーアウト表示され文字列コピーはできるが入力はできません。
このプロパティは認証登録系のメソッドに対し、プロダクト ID を渡すためだけに利用され、認証登録
処理後に実際に登録されたプロダクト ID で自動的に書き換えられるものではありません。
対象となる認証登録系メソッドは、次の通りです。
「認証登録/インターネット」処理の呼び出し（ActivateRegisterInternetメソッド）「認証登録/電話」処理の呼び出し（ActivateRegisterTelephoneメソッド）「認証登録状態回復」処理の呼び出し（RestoreRegisterStatusメソッド）「代理認証登録/実行」処理の呼び出し（ProxyActivateRegisterExecute メソッド）
SetProductID、SetSerialNoプロパティの目的
プロダクトIDやシリアルNo.に貴社が取り決めたある識別を設けた場合に、意図したように認証登録を行うため。

「認証レスキュー！.NET」 ユーザーズガイド- 105 -

SetSerialNo プロパティ【機能】
認証登録時の設定シリアル No.（デフォルト：空文字列）を設定します。
【構文】<VB.NET>
Public Property SetSerialNo As String<C#>public string SetSerialNo { set; get; }【解説】
このプロパティが空文字列の場合は、認証登録系のメソッドで表示されるダイアログのシリアルNo.
用のテキストボックスは、エンドユーザによる入力が可能となります。
このプロパティが空文字列ではない場合は、認証登録系のメソッドで表示されるダイアログ中のシリ
アルNo.用のテキストボックスにこのプロパティ値がグレーアウト表示され文字列コピーはできるが入力はできません。
このプロパティは認証登録系のメソッドに対し、シリアルNo.を渡すためだけに利用され、認証登録
処理後に実際に登録されたシリアルNo.で自動的に書き換えられるものではありません。
対象となる認証登録系メソッドは、次の通りです。
「認証登録/インターネット」処理の呼び出し（ActivateRegisterInternetメソッド）「認証登録/電話」処理の呼び出し（ActivateRegisterTelephoneメソッド）「認証登録状態回復」処理の呼び出し（RestoreRegisterStatusメソッド）「代理認証登録/実行」処理の呼び出し（ProxyActivateRegisterExecute メソッド）
このプロパティの目的と利用例は、SetProductID プロパティの説明をご覧ください。

「認証レスキュー！.NET」 ユーザーズガイド- 106 -

TelephoneNumber プロパティ【機能】
電話で認証時の電話番号を設定します。
【構文】<VB.NET>
Public Property TelephoneNumber As String<C#>public string TelephoneNumber { set; get; }【解説】
エンドユーザがインターネットを使わずに電話での認証を行う「認証登録/電話」処理で、エンドユー
ザがかける電話の番号を指定します。

「認証レスキュー！.NET」 ユーザーズガイド- 107 -

TrialPeriod プロパティ【機能】猶予（試用）日数（デフォルト：0 日、設定可能範囲：1～365）を設定します。
【構文】<VB.NET>
Public Property TrialPeriod As Integer<C#>public int TrialPeriod { set; get; }【解説】
エンドユーザがライセンス認証登録をしなくてもアプリケーションが動作する期間を指定します。
1（日）～365（日）の間で設定できます。
この TrialPeriod プロパティを 0 に設定すると、猶予期間は無いことになり、ライセンス認証登録をしない限りアプリケーション（またはアプリケーションの主機能など）が動作しないようにできます。

「認証レスキュー！.NET」 ユーザーズガイド- 108 -

TrialPeriodName プロパティ【機能】猶予（試用）期間の名称（デフォルト："猶予（試用）"）を設定します。
【構文】<VB.NET>
Public Property TrialPeriodName As String<C#>public string TrialPeriodName { set; get; }【解説】
たとえば、ActivateStatusDisp メソッドでは認証状態が表示されます。現在、猶予（試用）中ならば、「猶予（試用）期間残日数：6 日」といったように表示されます。その中の「猶予（試用）」という文字列を別の文字列で指定することができます。それがこの TrialPeriodName プロパティです。
（例）"体験版"「認証レスキュー！.NET」 ユーザーズガイド- 109 -

UseCpuInfo プロパティ【機能】CPU 情報の使用（デフォルト：True）を設定します。
次の 3 つのメソッドの処理において、認証情報とエンドユーザ PC 内の CPU 情報とを照合するかどうかを設定します。
・ActivateStatusCheck メソッド（エンドユーザ PC 内での認証状態の確認）
・ActivateStatusCheckOnline メソッド（オンラインで認証状態の確認）
・RestoreRegisterStatus メソッド（認証登録状態回復」処理の呼び出し）【構文】<VB.NET>
Public Property UseCpuInfo As Boolean<C#>public bool UseCpuInfo { set; get; }【解説】
認証レスキュー！の認証 UI ライブラリでは、認証登録など各処理時にエンドユーザ PC の CPU 情報を記録します。等プロパティを True にするとエンドユーザ PC の CPU 情報を認証識別情報として利用します。これを利用することでエンドユーザ PC の不正利用時の認証識別情報の精度を上げます。
※RestoreRegisterStatus メソッド（認証登録状態回復」処理の呼び出し）を使用する際は、当プロパ
ティを必ず True に設定してください。

「認証レスキュー！.NET」 ユーザーズガイド- 110 -

UseMacAddress プロパティ【機能】
MAC アドレスの使用（デフォルト：True）を設定します。
次の 3 つのメソッドの処理において、認証情報とエンドユーザ PC 内の MAC アドレスとを照合するかどうかを設定します。
・ActivateStatusCheck メソッド（エンドユーザ PC 内での認証状態の確認）
・ActivateStatusCheckOnline メソッド（オンラインで認証状態の確認）
・RestoreRegisterStatus メソッド（認証登録状態回復」処理の呼び出し）【構文】<VB.NET>
Public Property UseMacAddress As Boolean<C#>public bool UseMacAddress { set; get; }【解説】
認証レスキュー！の認証 UI ライブラリでは、認証登録など各処理時にエンドユーザ PC の MAC アド
レスを最大で 5 個記録します。MAC アドレスは LAN ポートなどのネットワーク機器に固有な物理アドレスです。
当プロパティを True にするとエンドユーザ PC の MAC アドレスを認証識別情報として利用します。
これを利用することでエンドユーザ PC の不正利用時の認証識別情報の精度を上げます。
※RestoreRegisterStatus メソッド（認証登録状態回復」処理の呼び出し）を使用する際は、当プロパ
ティを必ず True に設定してください。

「認証レスキュー！.NET」 ユーザーズガイド- 111 -

VendorsProductStartRegistryKeyPath プロパティ【機能】
ベンダアプリケーション開始レジストリキーパスを設定します。
【構文】<VB.NET>
Public Property VendorsProductStartRegistryKeyPath As String<C#>public string VendorsProductStartRegistryKeyPath { set; get; }【解説】
エンドユーザに配布したアプリケーションが認証 UI ライブラリ（DLL）の機能を使う場合、その各種情報の記録先として使うエンドユーザ PC 上のレジストリの開始キーのパスを指定します。レジストリ内の「HKEY_LOCAL_MACHINE」以降を指定します。
（例）"Software\Newtone\NinshoRescue\NRD\SampleProject"
なお、物理的なレジストリの位置は動作する貴社のアプリケーションが32bitなのか64bitなのかと、動作するPCのOSが32bitなのか64bitなのかによって異なります。
たとえば、HKEY_LOCAL_MACHINE\SOFTWARE\ABCというレジストリパスは次のようになります。
32bitOS上で32bitアプリケーションが動作する場合、または64bitOS上で64bitアプリケーションが動作する場合は、
HKEY_LOCAL_MACHINE\SOFTWARE\ABC
そのままです。
しかし、64bitOS上で32bitアプリケーションが動作する場合は、
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ABCとなります。
また、貴社の異なる複数のアプリケーションをエンドユーザの同一PC上で使用させるには、このVendorsProductStartRegistryKeyPathプロパティにアプリケーションごとのそれぞれ異なるレジスト
リパスを設定してください。たとえば、次のように設定します。
アプリケーションA内での設定コード例：
VendorsProductStartRegistryKeyPath = "Software\Company\A"
アプリケーションB内での設定コード例：
VendorsProductStartRegistryKeyPath = "Software\Company\B"「認証レスキュー！.NET」 ユーザーズガイド- 112 -WebServiceBasicAuthenticationPassword プロパティ【機能】
Web サービス時の基本認証パスワードを設定します。
【構文】<VB.NET>
Public Property WebServiceBasicAuthenticationPassword As String<C#>public string WebServiceBasicAuthenticationPassword { set; get; }【解説】
Web サーバーで基本認証を使用する場合に、そのパスワードを指定します。
基本認証に関しては、WebServiceUseBasicAuthentication プロパティを参照してください。

「認証レスキュー！.NET」 ユーザーズガイド- 113 -WebServiceBasicAuthenticationUserName プロパティ【機能】
Web サービス時の基本認証ユーザ名を設定します。
【構文】<VB.NET>
Public Property WebServiceBasicAuthenticationUserName As String<C#>public string WebServiceBasicAuthenticationUserName { set; get; }【解説】
Web サーバーで基本認証を使用する場合に、そのユーザ名を指定します。
基本認証に関しては、WebServiceUseBasicAuthentication プロパティを参照してください。

「認証レスキュー！.NET」 ユーザーズガイド- 114 -WebServiceCheckPassword プロパティ【機能】
Web サービス確認パスワード(8 文字以上)を設定します。
【構文】<VB.NET>
Public Property WebServiceCheckPassword As String<C#>public string WebServiceCheckPassword { set; get; }【解説】
Web サービスを利用する場合の確認用のパスワードを設定します。ここでは、Web サーバー側設定
アプリケーション「認証 Web サービス」の環境設定処理の Web サービスの確認パスワードと同じものを設定します。
確認パスワードは必須項目です、省略はできません。8 文字以上で半角の次の文字が使用できます。
・大文字の英字（A～Z）
・小文字の英字（a～ｚ）
・数字（0～9）・記号（+-*/!#$%&()=\@<>?）「認証レスキュー！.NET」 ユーザーズガイド- 115 -WebServiceTimeout プロパティ【機能】
Web サービスのタイムアウト（デフォルト：60 秒）を設定します。
【構文】<VB.NET>
Public Property WebServiceTimeout As Integer<C#>public int WebServiceTimeout { set; get; }【解説】
Web サービスに接続して応答を待つ最大時間を秒単位で指定します。初期値は 60 秒です。

「認証レスキュー！.NET」 ユーザーズガイド- 116 -WebServiceURL プロパティ【機能】
Web サービスの URL を設定します。
【構文】<VB.NET>
Public Property WebServiceURL As String<C#>public string WebServiceURL { set; get; }【解説】
認証に関するシステムを Web サービスとして提供する Web サーバーの URL を指定します。
以下に例を示します。
自 PC のローカルホストの Web サーバー（IIS）にアクセスする例："http://localhost/NRDWebService/Service.asmx"（注）この例は実際の運用ではありえません。貴社のアプリケーションで認証 UI ライブラリ（DLL）を使用した開発時に、テスト用に使用される URL です。
自社 Web サーバー（IIS）にアクセスさせる例："http://www.newtone.co.jp/NRDWebService/Service.asmx"
クラウドサービス Microsoft Azure の Web アプリ（App Service）に配置した Web サービスを利用する例："http://newtonecojp.azurewebsites.net/Service.asmx"「認証レスキュー！.NET」 ユーザーズガイド- 117 -WebServiceUseBasicAuthentication プロパティ【機能】
Web サービス時の基本認証の使用（デフォルト：False）を設定します。
【構文】<VB.NET>
Public Property WebServiceUseBasicAuthentication As Boolean<C#>public bool WebServiceUseBasicAuthentication { set; get; }【解説】
Web サーバーで基本認証を使用する場合は、この WebServiceUseBasicAuthentication プロパティをTrue にします。
初期値は、False（基本認証を使用しない）です。
この WebServiceUseBasicAuthentication プロパティは、Web サーバー（IIS）側で特定のアカウント（ユーザ名とパスワード）でアクセスできるフォルダにこの Web サービスが配置してある場合に使用できるセキュリティ設定です。
Web サーバーで基本認証を使用する一般的な手順は次の通りです。
1.サーバーPC 上でユーザを作成。
この際のユーザ名とパスワードがそのまま基本認証に使われます。
2.基本認証フォルダのセキュリティ設定
フォルダのプロパティを開き、セキュリティタブで上記 1 のユーザ名を 追加し、「読み取り」権限を付与します。
3.IIS でのセキュリティ設定
IIS で該当フォルダに対し「認証」の設定で「匿名認証」を無効にして 「基本認証」を有効にします。
なお、Web サーバーでの基本認証の詳細につきましてはマイクロソフト社の関連ドキュメントをご覧ください。

「認証レスキュー！.NET」 ユーザーズガイド- 118 -

<既定 UI 系メソッド>
メソッド一覧
メソッド
ActivateRegisterInternet
ActivateRegisterTelephone
ActivateRemoveInternet
ActivateRemoveTelephone
ActivateStatusCheck
ActivateStatusCheckOnline
ActivateStatusDisp
ActivateStatusOnlineVerify
DeterminationOfProxyUpdateOfExpirationDate
FloatingLicenseFinish
FloatingLicenseStart
GetProxyUpdateOfExpirationDate
PreparationOfProxyUpdateOfExpirationDate
ProxyActivateRegisterExecute
ProxyActivateRegisterFix
ProxyActivateRegisterPrepare
ProxyActivateRemoveExecute
ProxyActivateRemovePrepare
RestoreCancelStatus
RestoreRegisterStatus
RunNR2AppDateRemove
TrialStartDateRemove
UpdateOfExpirationDate

機能「認証登録/インターネット」処理の呼び出し「認証登録/電話」処理の呼び出し「認証解除/インターネット」処理の呼び出し「認証解除/電話」処理の呼び出し
エンドユーザ PC 内での認証状態の確認
オンラインで認証状態の確認「認証状態表示」処理の呼び出し「認証状況オンライン表示」処理の呼び出し「代理有効期限更新/確定」処理の呼び出し「フローティングライセンス使用終了」処理の呼び
出し「フローティングライセンス使用開始」処理の呼び出し「代理有効期限/取得」処理の呼び出し（代理 PC
で利用）「代理有効期限更新/準備」処理の呼び出し「代理認証登録/実行」処理の呼び出し（代理 PC
で利用）「代理認証登録/確定」処理の呼び出し「代理認証登録/準備」処理の呼び出し「代理認証解除/実行」処理の呼び出し（代理 PC
で利用）「代理認証解除/準備」処理の呼び出し「認証解除状態回復」処理の呼び出し「認証登録状態回復」処理の呼び出し「アプリ起動日」を削除「猶予日数」の「開始日」を削除「有効期限の更新」処理の呼び出し「認証レスキュー！.NET」 ユーザーズガイド- 119 -

ActivateRegisterInternet メソッド
【機能】
「認証登録/インターネット」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function ActivateRegisterInternet() As Boolean<C#>public bool ActivateRegisterInternet()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「認証登録/インターネット」処理の呼び出しを行います。

なお、何らかの原因で、データベースは登録済、エンドユーザ PC のレジストリが解除済の状態になった場合は、次のようなダイアログが表示されます。

「認証レスキュー！.NET」 ユーザーズガイド- 120 -

この場合、エンドユーザ様がお使いの PC レジストリの状態をご確認の上、「認証登録状態回復メソッド」処理をしていただくか、認証管理システムの「電話認証解除の対応」の「クラッシュ（お客様の P
C が動作不能になった場合）」で、プラス許可数を 1 増やしてご対応ください。

「認証レスキュー！.NET」 ユーザーズガイド- 121 -

ActivateRegisterTelephone メソッド
【機能】
「認証登録/電話」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function ActivateRegisterTelephone() As Boolean<C#>public bool ActivateRegisterTelephone()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「認証登録/電話」処理の呼び出しを行います。

「認証レスキュー！.NET」 ユーザーズガイド- 122 -

ActivateRemoveInternet メソッド【機能】
「認証解除/インターネット」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function ActivateRemoveInternet() As Boolean<C#>public bool ActivateRemoveInternet()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「認証解除/インターネット」処理の呼び出しを行います。

なお、何らかの原因で、データベースは解除済、エンドユーザ PC のレジストリが登録状態になった場合は、次のようなダイアログが表示されます。

「認証レスキュー！.NET」 ユーザーズガイド- 123 -

この場合、エンドユーザ様がお使いの PC レジストリの状態をご確認の上、「代理認証解除-準備」処理をしていただくか、「認証解除状態回復メソッド」を行っていただくよう、お伝えください。

「認証レスキュー！.NET」 ユーザーズガイド- 124 -

ActivateRemoveTelephone メソッド【機能】
「認証解除/電話」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function ActivateRemoveTelephone() As Boolean<C#>public bool ActivateRemoveTelephone()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「認証解除/電話」処理の呼び出しを行います。

「認証レスキュー！.NET」 ユーザーズガイド- 125 -

ActivateStatusCheck メソッド【機能】
エンドユーザ PC 内での認証状態の確認を行います。
【構文】<VB.NET>
Public Function ActivateStatusCheck() As Integer<C#>public int ActivateStatusCheck()

【引数】
なし
【戻り値】
0：
1～365：
366：
400：
500：
600：
1000：
1001～2100：
2101：
-999：
-1：
-21001231～-20000101：-21001232：-3：
20000101～21001231：
200001010～210012310：-210012310～-200001010：

猶予期限切れ（猶予有効時）
猶予日数有
日付データの取得失敗（猶予）
未認証（猶予無効時）
認証済み
フローティングライセンス登録済
欠番（旧レンタル機能関連）
欠番（旧レンタル機能関連）
欠番（旧レンタル機能関連）
認証済ハードウェア情報不一致
エラー（未設定や範囲を超えているプロパティがある）
認証済で終了した有効期限（2000/01/01～2100/12/31）
日付データの取得失敗（有効期限）
PC の日付が変更されました。
認証済でまだ有効な有効期限（2000/01/01～2100/12/31）
フローティングライセンスが登録済でまだ有効な有効期限（2000/01/01～2100/12/31）
フローティングライセンスが登録済で終了した有効期限（2000/01/01～2100/12/31）<戻り値が-1 の場合の補足説明>
本来設定が必須であるプロパティに値がセットされていない場合やセットした値が無効な場合などに（-1）が返ります。たとえば、「猶予（試用）期間の名称」用の TrialPeriodName プロパティに（猶予 ・試用期間機能を使用しないということで未設定にして結果として）空文字列を設定した場合や電話で認証時の電話番号用の TelephoneNumber プロパティに（電話対応機能を使用しないということで未設定にして結果として）空文字列を設定した場合などにこの戻り値（-1）が返ります。DLL のプ
ロパティは機能の使用有無に関係なく DLL の起動時にそれらの値をチェックするようになっていて、
上記のような空文字列などの場合その機能の利用時に問題が発生することをあらかじめ防止する目的で戻り値（-1）が返ります。
<戻り値が 200001010～210012310 または-210012310～-200001010 の場合>
戻り値を 10 で割って値が有効期限となります。
例：「認証レスキュー！.NET」 ユーザーズガイド- 126 -

戻り値が 202412200 の場合
202412200 ÷ 10 = 20241220
1～4 桁目が年→2024
5～6 桁目が月→12
7～8 桁目が日→20
よって、2024 年 12 月 20 日となります。
【解説】
この ActivateStatusCheck メソッドと ActivateStatusCheckOnline メソッドの相違点はActivateStatusCheck メソッドがエンドユーザ PC 内での認証状況を返すのに対し、ActivateStatusCheckOnline メソッドはインターネットを介し貴社のデータベースにアクセスして取得した情報とエンドユーザ PC 内の情報とを照合して認証状況を返す点です。

「認証レスキュー！.NET」 ユーザーズガイド- 127 -

ActivateStatusCheckOnline メソッド
【機能】
オンラインで認証状態の確認を行います。
【構文】<VB.NET>
Public Function ActivateStatusCheckOnline() As Integer<C#>public int ActivateStatusCheckOnline()

【引数】
なし
【戻り値】
0：
PC レベルで認証されていない（PC のレジストリには認証登録情報がない）
1：
OK（PC レベルと DB で認証登録情報が一致した）
2：
NG（PC レベルと一致する認証登録情報が DB にない）
3：
NG（認証済ハードウェア情報不一致）
4：
NG（日付データの取得失敗（猶予））5：
欠番（旧レンタル機能関連）
6：
NG（日付データの取得失敗（有効期限））-11：
接続できない（認証時は電話）-12：接続できない（認証時は代理）-13：接続できない（フローティングライセンス）-999： その他エラー（接続できないなど）-1：
エラー（未設定や範囲を超えているプロパティがある）-3：
PC の日付が変更されました。
600：
フローティングライセンス登録済<戻り値が-1 の場合の補足説明>
本来設定が必須であるプロパティに値がセットされていない場合やセットした値が無効な場合などに（-1）が返ります。たとえば、「猶予（試用）期間の名称」用の TrialPeriodName プロパティに（猶予・試用期間機能を使用しないということで未設定にして結果として）空文字列を設定した場合や電話で認証時の電話番号用の TelephoneNumber プロパティに（電話対応機能を使用しないということで未設定にして結果として）空文字列を設定した場合などにこの戻り値（-1）が返ります。DLL のプロ
パティは機能の使用有無に関係なく DLL の起動時にそれらの値をチェックするようになっていて、上記のような空文字列などの場合その機能の利用時に問題が発生することをあらかじめ防止する目
的で戻り値（-1）が返ります。
【解説】
この ActivateStatusCheckOnline メソッドと ActivateStatusCheck メソッドとの相違点はActivateStatusCheck メソッドがエンドユーザ PC 内での認証状況を返すのに対し、ActivateStatusCheckOnline メソッドはインターネットを介し貴社のデータベースにアクセスして取得した情報とエンドユーザ PC 内の情報とを照合して認証状況を返す点です。
この ActivateStatusCheckOnline メソッドは、なんらかの理由で現在エンドユーザが使用している貴社のアプリケーションを使用不可としたい場合などに利用できます。

「認証レスキュー！.NET」 ユーザーズガイド- 128 -

認証登録の場合、レジストリとハード情報だけの確認で OK となってしまい貴社がデータベース（DB）
上の当該情報を削除してもエンドユーザの PC ではアプリケーションが継続して使用できてしまいます。そこで、任意のタイミングでインターネットを介し貴社のデータベースにアクセスしてそれらの情報を確認できる機能がこのメソッドです。貴社はたとえば、アプリケーションの起動時にそのメソッドを利用するコードを記述し、その戻り値によってアプリケーションを（強制的に）終了する、といった挙動を制御できます。
インターネットを介し Web サービスに接続できなかった場合は、次の「インターネットに接続」ダイアログを表示します。

このダイアログでのエンドユーザの選択肢は次の通りです。
・「接続」ボタン→現在の内容で再度接続する。
・「キャンセル」ボタン→このダイアログを閉じて、該当する戻り値を返してメソッド終了
なお、このダイアログ内で必要に応じてプロキシサーバーの接続設定が可能です。

「認証レスキュー！.NET」 ユーザーズガイド- 129 -

ActivateStatusDisp メソッド
【機能】
「認証状態表示」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function ActivateStatusDisp() As Boolean<C#>public bool ActivateStatusDisp()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】
エンドユーザ PC 内での認証状態の表示を行います。
呼び出したダイアログの例を以下に示します。

「認証レスキュー！.NET」 ユーザーズガイド- 130 -

（猶予期間中）（認証登録済み）（有効期限中）「認証レスキュー！.NET」 ユーザーズガイド- 131 -

ActivateStatusOnlineVerify メソッド
【機能】
「認証状況オンライン表示」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function ActivateStatusOnlineVerify() As Boolean<C#>public bool ActivateStatusOnlineVerify()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】
エンドユーザ PC 内でのフローティングライセンスの状況の表示を行います。
呼び出したダイアログの例を以下に示します。

「認証レスキュー！.NET」 ユーザーズガイド- 132 -

DeterminationOfProxyUpdateOfExpirationDate メソッド
【機能】
「代理有効期限更新/確定」処理の呼び出しを行います。
（代理有効期限更新機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function DeterminationOfProxyUpdateOfExpirationDate() As Boolean<C#>public bool DeterminationOfProxyUpdateOfExpirationDate()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「代理有効期限更新/確定」処理の呼び出しを行います。

「認証レスキュー！.NET」 ユーザーズガイド- 133 -

FloatingLicenseFinish メソッド
【機能】
「フローティングライセンス使用終了」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function FloatingLicenseFinish() As Boolean<C#>public bool FloatingLicenseFinish()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「フローティングライセンス使用終了」処理の呼び出しを行います。
この処理では、「使用終了」および「解除」が行えます。
「使用終了」のみ行い、「解除」を行わない場合、エンドユーザ PC にフローティングライセンス情報が登録済状態ですので、「フローティングライセンス使用開始」処理で、「プロダクト ID」と「シリアル No.」は自動的に表示されます。
また、「使用終了」を行わないとフローティングライセンスを 1 ライセンス使用中のままとなりますので、ご注意ください。

「認証レスキュー！.NET」 ユーザーズガイド- 134 -

FloatingLicenseStart メソッド
【機能】
「フローティングライセンス使用開始」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function FloatingLicenseStart() As Boolean<C#>public bool FloatingLicenseStart()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「フローティングライセンス使用開始」処理の呼び出しを行います。
「フローティングライセンス使用開始」処理を初めて行う場合、「プロダクト ID」と「シリアル No.」の入力が必要になります。その後は、「フローティングライセンス解除」処理を行わない限り、入力は不要です。
入力されたプロダクト ID とシリアル No.がデータベースに存在するか確認後、エンドユーザ PC に情報を登録します。その後、使用開始します。
このメソッドは、TrialPeriod プロパティが 0 以上に設定されている場合、実行できません。
＜初めてのフローティングライセンス使用開始時＞「認証レスキュー！.NET」 ユーザーズガイド- 135 -

＜フローティングライセンス解除がされていない場合＞

たとえば、「フローティングライセンス使用開始」処理を初めて行った時に設定されていた「有効期限」
が 2024 年 7 月 31 日だとします。
その後、データベース側で「有効期限」を 2024 年 12 月 31 日に更新された場合、「フローティングラ
イセンス使用開始」処理を実行すると次のメッセージが表示されます。
この場合、「フローティングライセンス解除」を行ってから、再度、当処理を行ってください。

「認証レスキュー！.NET」 ユーザーズガイド- 136 -

GetProxyUpdateOfExpirationDate メソッド
【機能】
「代理有効期限/取得」処理の呼び出し（代理 PC で利用）を行います。
（代理有効期限更新機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function GetProxyUpdateOfExpirationDate () As Boolean<C#>public bool GetProxyUpdateOfExpirationDate ()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「代理有効期限/取得」処理の呼び出し（代理 PC で利用）を行います。

「認証レスキュー！.NET」 ユーザーズガイド- 137 -

PreparationOfProxyUpdateOfExpirationDate メソッド
【機能】
「代理有効期限更新/準備」処理の呼び出しを行います。
（代理有効期限更新機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function PreparationOfProxyUpdateOfExpirationDate() As Boolean<C#>public bool PreparationOfProxyUpdateOfExpirationDate ()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「代理有効期限更新/準備」処理の呼び出しを行います。

「認証レスキュー！.NET」 ユーザーズガイド- 138 -

ProxyActivateRegisterExecute メソッド
【機能】
「代理認証登録/実行」処理の呼び出し（代理 PC で利用）を行います。
（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function ProxyActivateRegisterExecute() As Boolean<C#>public bool ProxyActivateRegisterExecute()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「代理認証登録/実行」処理の呼び出し（代理 PC で利用）を行います。

「認証レスキュー！.NET」 ユーザーズガイド- 139 -

ProxyActivateRegisterFix メソッド
【機能】
「代理認証登録/確定」処理の呼び出しを行います。
（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function ProxyActivateRegisterFix() As Boolean<C#>public bool ProxyActivateRegisterFix()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「代理認証登録/確定」処理の呼び出しを行います。

「認証レスキュー！.NET」 ユーザーズガイド- 140 -

ProxyActivateRegisterPrepare メソッド
【機能】
「代理認証登録/準備」処理の呼び出しを行います。
（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function ProxyActivateRegisterPrepare() As Boolean<C#>public bool ProxyActivateRegisterPrepare()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「代理認証登録/準備」処理の呼び出しを行います。

「認証レスキュー！.NET」 ユーザーズガイド- 141 -

ProxyActivateRemoveExecute メソッド
【機能】
「代理認証解除/実行」処理の呼び出し（代理 PC で利用）を行います。
（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function ProxyActivateRemoveExecute() As Boolean<C#>public bool ProxyActivateRemoveExecute()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「代理認証解除/実行」処理の呼び出し（代理 PC で利用）を行います。

「認証レスキュー！.NET」 ユーザーズガイド- 142 -

ProxyActivateRemovePrepare メソッド
【機能】
「代理認証解除/準備」処理の呼び出しを行います。
（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function ProxyActivateRemovePrepare() As Boolean<C#>public bool ProxyActivateRemovePrepare()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「代理認証解除/準備」処理の呼び出しを行います。

「認証レスキュー！.NET」 ユーザーズガイド- 143 -

RestoreCancelStatus メソッド【機能】
「認証解除状態回復」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function RestoreCancelStatus() As Boolean<C#>public bool RestoreCancelStatus()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「認証解除状態回復」処理の呼び出しを行います。
「ライセンス認証解除」でデータベースの解除に成功したが、エンドユーザ PC での認証解除が失敗した状態になった場合に、このメソッドによる処理でエンドユーザの操作でその状態を回復しエンド
ユーザ PC を認証解除状態とします。

「認証レスキュー！.NET」 ユーザーズガイド- 144 -

RestoreRegisterStatus メソッド
【機能】
「認証登録状態回復」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function RestoreRegisterStatus() As Boolean<C#>public bool RestoreRegisterStatus()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「認証登録状態回復」処理の呼び出しを行います。
「ライセンス認証登録」でデータベースの登録に成功したが、エンドユーザ PC での認証登録が失敗した状態になった場合に、このメソッドによる処理でエンドユーザの操作でその状態を回復しエンド
ユーザ PC を認証登録状態とします。

「認証レスキュー！.NET」 ユーザーズガイド- 145 -

RunNR2AppDateRemove メソッド
【機能】
「アプリ起動日」を削除します。
【構文】<VB.NET>
Public Function RunNR2AppDateRemove() As Boolean<C#>public bool RunNR2AppDateRemove()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「アプリ起動日」を削除します。
認証レスキュー！を含む貴社のアプリを起動した際に、レジストリに記録されている前回の「アプリ起動日」を確認します。
（もし、「アプリ起動日」が存在しなかった場合は、起動した際にレジストリに記録します。）
その「アプリ起動日」より PC の日付が古い場合、故意に PC の日付が変更されたということで「PCの日付が変更されました。）」というメッセージが表示されます。
例：
たとえば、本日を 6 月 1 日とします。PC の日付を 6 月 2 日に設定しアプリを起動します。
次に、PC の日付を本日（つまり 6 月 1 日）に戻しても、「アプリ起動日」は 6 月 2 日で記録されており、PC の日付が古いので「PC の日付が変更されました。」というメッセージが表示されます。
この状態になった場合、PC の日付を 6 月 2 日に設定しない限り、認証登録等が実行できません。
このメソッドを実行後は、再度 PC の日付を本日（つまり 6 月 1 日）に設定して、アプリをご利用いただける状態にします。

「認証レスキュー！.NET」 ユーザーズガイド- 146 -

TrialStartDateRemove メソッド
【機能】
「猶予日数」の「開始日」を削除します。
【構文】<VB.NET>
Public Function TrialStartDateRemove() As Boolean<C#>public bool TrialStartDateRemove()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「猶予日数」の「開始日」を削除します。
このメソッドを実行後は、エンドユーザは再度「猶予日数」分の利用が可能になります。

「認証レスキュー！.NET」 ユーザーズガイド- 147 -

UpdateOfExpirationDate メソッド
【機能】
「有効期限の更新」処理の呼び出しを行います。
【構文】<VB.NET>
Public Function UpdateOfExpirationDate() As Boolean<C#>public bool UpdateOfExpirationDate()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）【解説】「有効期限の更新」処理の呼び出しを行います。
プロダクト ID とシリアル No.が有効期限によるライセンスの場合、当処理を利用してエンドユーザに有効期限を更新させることができます。
この処理をエンドユーザに実行してもらう前に、貴社で新しい有効期限の設定をする必要があります。
有効期限の設定は認証管理システムの「認証キー編集（表形式）」処理を利用します。

なお、エンドユーザに有効期限を更新させる方法として当処理を実行させる他に、エンドユーザに一度認証の解除後、再度認証の登録をしてもらうことでも更新が完了します。
エンドユーザが代理認証を利用している場合で、有効期限によるライセンスを更新する場合はその方法を使います。

「認証レスキュー！.NET」 ユーザーズガイド- 148 -

<カスタム UI 系プロパティ>
プロパティ一覧
プロパティ
APIError 列挙体
APICertificationID
APICurrentExpirationDate
APIDisabledNICIgnore
APIEncryptionPassword
APIEncryptionSaltString
APIErrorStatus
APIExternalLinkKey
APIFloatingLicenseDataInfo
APIFloatingLicenseMaxCount
APIFloatingLicenseState
APIFloatingLicenseUsedCount
APIFreeItem1～5
APILicenseKey
APINewExpirationDate
APIOverwriteModeOfExpirationDateUpdate
APIProductID
APIProductIdSerialNoList

APIProxyDataPath
APIProxyServerAddress
APIProxyServerPassword
APIProxyServerPort
APIProxyServerUserName
APIReleaseKey
APIReleaseStatus
APISelectRunAppDatePathFlag
APISerialNo
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIUseProxyServer
APIVendorsProductStartRegistryKeyPath

機能
エラー内容を表します。
認証 ID（取得専用）
現在の有効期限（取得専用）
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワードを設定
暗号化時の Salt 文字列を設定
カスタム UI 系のメソッドを使用した際のエラーの内容を返す。（取得専用）
APIGetProductIdSerialNoList メソッド 実行時の外部データベースとのリンク用キー項目を設定
フローティングライセンス使用中の PC 一覧を文字列として取得します。（取得専用）
フローティングライセンスの最大ライセンス数（取得
専用）
フローティングライセンス状況（取得専用）
フローティングライセンスのライセンス使用数（取得
専用）
APIGetFreeItem メソッド 実行後に自由入力項目
1～5 が設定される（取得専用）
ライセンスキー
新しい有効期限を取得します。（取得専用）「有効期限の更新」実行時の有効期限新旧上書きの設定
プロダクト ID
APIGetProductIdSerialNoList メソッド実行後にプロダクト ID とシリアル No.のペアをデリミタで列挙したの文字列が設定される（取得専用）
代理認証データパス
プロキシサーバーのアドレス
プロキシサーバーのパスワード
プロキシサーバーのポート
プロキシサーバーのユーザ名
解除キー
解除ステータス（取得専用）「アプリ起動日」の読み込み/書き込み場所の切り
替えフラグ
シリアル No.
猶予（試用）日数を設定
CPU 情報の使用を設定
MAC アドレスの使用を設定
プロキシサーバーの使用区分
ベンダアプリケーション開始レジストリキーパスを設定「認証レスキュー！.NET」 ユーザーズガイド- 149 -

APIWebServiceBasicAuthenticationPassword
APIWebServiceBasicAuthenticationUserName
APIWebServiceCheckPassword
APIWebServiceTimeout
APIWebServiceURL
APIWebServiceUseBasicAuthentication

Web サービス時の基本認証パスワードを設定
Web サービス時の基本認証ユーザ名を設定
Web サービス確認パスワードを設定
Web サービスのタイムアウトを設定
Web サービスの URL を設定
Web サービス時の基本認証の使用を設定「認証レスキュー！.NET」 ユーザーズガイド- 150 -

APIError 列挙体
エラー内容を表します。
public enum APIError
パブリックメンバ
メンバ名
None
OutOfMemoryException

値
011

StackOverflowException

12

UnauthorizedAccessExcep
tion

13

IoDirectoryNotFoundExcep
tion

14

IoDriveNotFoundException

15

IoEndOfStreamException

16

IoFileLoadException

17

IoFileNotFoundException

18

IoIOException

19

IoPathTooLongException

20

BadStrInProductID

101

内容

関連するメソッド

エラーなし
プログラムの実行を継続するためのメモリが不足している場合にスローされる例外。
入れ子になったメソッド呼び出しが多くなりすぎ、実行スタックがオーバーフ
ローした場合にスローされる例
外。 このクラスは継承できません。
オペレーティング システムが I/O エラーまたは特定の種類のセキュリティ
エラーのためにアクセスを拒否す
る場合、スローされる例外。
ファイルまたはディレクトリの一部が見つからない場合にスローされる例
外。
使用できないドライブまたは共有にアクセスしようとするとスローされる例
外。
ストリームの末尾を越えて読み取ろうとしたときにスローされる例外。
マネージ アセンブリが見つかったが、読み込むことができない場合にスローされる例外。
ディスク上に存在しないファイルにア
クセスしようとして失敗したときにスローされる例外。
I/O エラーが発生したときにスローされる例外。
パス名またはファイル名がシステム定義の最大長を超えている場合にスローされる例外。
プロダクト ID に不正な文字が含まれ APIActivateRegistています。
erInternet
APIActivateRegist
erTelephone
APIProxyActivateR
egisterExecute
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetFreeItem
APIGetRegisteredI
nfoFromWeb「認証レスキュー！.NET」 ユーザーズガイド- 151 -

BadStrInSerialNo

102

BadInputData103

APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Finishシリアル No.に不正な文字が含まれて APIActivateRegist
います。
erInternet
APIActivateRegist
erTelephone
APIProxyActivateR
egisterExecute
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetFreeItem
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Finish
入力されたデータが不正です。
APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIProxyActivateR
egisterExecute
APIProxyActivateR
egisterFix
APIProxyActivateR
emoveExecute
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense「認証レスキュー！.NET」 ユーザーズガイド- 152 -

FailedEnableNIC

104

FailedDisableNIC

105

NoMACAdress

106

ActivationFailedException

107

Finish
NIC の設定に失敗しました。（有効化） APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIRestoreRegisterStatus
APIGetProxyDataF
orRegister
APIFloatingLicense
Register
NIC の設定に失敗しました。（無効化） APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIRestoreRegisterStatus
APIGetProxyDataF
orRegister
APIFloatingLicense
Register
MAC アドレスが 1 つも取得できません APIActivateRegist
でした。
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIRestoreRegisterStatus
APIGetProxyDataF
orRegister
APIFloatingLicense
Register
弊社のデータベースには正常に登録 APIActivateRegist「認証レスキュー！.NET」 ユーザーズガイド- 153 -

ExceedLicense

108

UnregisteredException

109

NotRegisteredException

110

AlreadyRegistered111

BadCheckPassword

112

されましたが、お客様の PC での認証 erInternet
登録が失敗しました。
ライセンス数を超えています。
APIActivateRegist
erInternet
APIProxyActivateR
egisterExecute
APIFloatingLicenseStart
指定されたプロダクト ID とシリアル№ APIActivateRegist
は弊社データベースに登録されてい erInternet
ません。
APIProxyActivateR
egisterExecute
APIUpdateOfExpira
tionDate
APIGetFreeItem
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
Start
何らかの原因で登録できませんでし APIActivateRegist
た。
erInternet
APIProxyActivateR
egisterExecute
APIUpdateOfExpira
tionDate
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
そのプロダクト ID + シリアル№ + 認 APIActivateRegist
証 ID は既に登録されているので登録 erInternet
できませんでした。
APIProxyActivateR
egisterExecute
APIFloatingLicenseStart
確認パスワードが不正です。
APIActivateRegist
erInternet
APIProxyActivateR
egisterExecute
APIActivateRemoveInternet
APIProxyActivateR
emoveExecute
APIRestoreCancel
Status
APIRestoreRegiste「認証レスキュー！.NET」 ユーザーズガイド- 154 -

BadWaiFile

113

WebServEnv.wai ファイルに問題があります。
認証 Web サービス実行 PC 上で「認証レスキュー！.NET Web 環境設定」（WebAdmin.exe）が行われていない可能性があります。

rStatusAPIUpdateOfExpira
tionDate
APIGetProductIdS
erialNoList
APIGetFreeItem
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus
OnlineVerify
APIActivateRegist
erInternet
APIProxyActivateR
egisterExecute
APIActivateRemoveInternet
APIProxyActivateR
emoveExecute
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetProductIdS
erialNoList
APIGetFreeItem
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus「認証レスキュー！.NET」 ユーザーズガイド- 155 -

OnlineVerify
114
115
116

旧登録ライセンス関連。
旧登録ライセンス関連

ExpirationDateIsOldDate

117

弊社のデータベース上の「有効期限」が無効（前日以前）になっていて更新できませんでした。
弊社にご連絡ください。

Authenticated118

既に認証済のため、この処理は無効です。

UnhandledProcess

119

何らかの原因のため、この処理は無
効です。

欠番
欠番

ExpirationDateIsOutOfRange

弊社のデータベース上の「有効期限」
が無効（範囲外など）になっていて更新できませんでした。
弊社にご連絡ください。

APIActivateRegist
erInternet
APIProxyActivateR
egisterExecute
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Start
APIActivateRegist
erInternet
APIProxyActivateR
egisterExecute
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Start
APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIRestoreRegisterStatus
APIGenerationOfN
ewCertificationID
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateRegist
erInternet
APIActivateRegist「認証レスキュー！.NET」 ユーザーズガイド- 156 -

UnexpectedError

120

erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGenerationOfN
ewCertificationID
APIGetRegisteredI
nfoFromRegistry
APIGetProductIdS
erialNoList
APIGetFreeItem
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Finish認証状況確認中に想定外のエラーが APIActivateRegist
発生しました"erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare「認証レスキュー！.NET」 ユーザーズガイド- 157 -

NoExpirationDateIsUsed

121

欠番
BadLicenseKey

122
123

ActivationFailed

124

DeauthorizeFailedException125

ProductIDAndSerialNoAnd
CertificationIDNotFound126

APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGenerationOfN
ewCertificationID
APIGetRegisteredI
nfoFromRegistry
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Finish
このプロダクト ID とシリアル No.には APIUpdateOfExpira
有効期限の利用設定はありません。
tionDate
APIPreparationOfP
roxyUpdateOfExpirationDate
APIGetProxyUpdat
eOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
旧レンタル機能関連
入力されたデータが不正です。
APIActivateRegist
erTelephone
お客様の PC での認証登録が失敗し APIActivateRegist
ました。
erTelephone
再度、当処理を実行してください。
APIProxyActivateR
egisterFix
弊社のデータベースには正常に解除 APIActivateRemov
されましたが、お客様の PC での認証 eInternet
解除が失敗しました。
指定されたプロダクト ID/シリアル№/ APIActivateRemov
認証 ID は弊社データベースに登録さ eInternet
れていません。
APIProxyActivateR
emoveExecute「認証レスキュー！.NET」 ユーザーズガイド- 158 -

NotDeauthorized127

何らかの原因で解除できませんでした。

UnauthenticatedByTrialPe
riodOut

128

認証登録されていないため、この処理は無効です。

UnauthenticatedByTrialPe
riod

129

認証登録されていないため、この処理は無効です。

Unauthenticated130

認証登録されていないため、この処理は無効です。

APIFloatingLicense
FinishAPIActivateRemoveInternet
APIProxyActivateR
emoveExecute
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIProxyActivateR
emovePrepare
APIRestoreCancel
StatusAPIUpdateOfExpira
tionDate
APIGetRegisteredI
nfoFromRegistry
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIProxyActivateR
emovePrepare
APIRestoreCancel
StatusAPIUpdateOfExpira
tionDate
APIGetRegisteredI
nfoFromRegistry
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status「認証レスキュー！.NET」 ユーザーズガイド- 159 -

HardwareInformationMisma
tch

131

ReleasekeyIsEmpty

132

ReleasekeyDigitsProblem

133

BadReleasekey

134

DeauthorizeFailed

135

ProxyAuthenticationDataFi
leNotFound136

APIUpdateOfExpira
tionDate
APIGetRegisteredI
nfoFromRegistry
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
認証済ハードウェア情報が不一致の APIActivateRemov
ため、この処理は無効です。
eInternet
APIActivateRemoveTelephone
APIProxyActivateR
emovePrepare
APIRestoreCancel
StatusAPIUpdateOfExpira
tionDate
APIGetRegisteredI
nfoFromRegistry
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Finish解除キーが不正です。
APIActivateRemoveTelephone
解除キーが不正です。
APIActivateRemoveTelephone
解除キーが不正です。
APIActivateRemoveTelephone
お客様の PC での認証解除が失敗し APIActivateRemovました。
eTelephone
再度、当処理を実行してください。
代理認証データファイルが存在しませ APIProxyActivateRん。
egisterExecute
APIProxyActivateR
egisterFix
APIProxyActivateR
emoveExecute
APIProxyActivateR「認証レスキュー！.NET」 ユーザーズガイド- 160 -

egisterExecute
APIProxyActivateR
emoveExecute
APIGetProxyDataF
orExpirationDate
APIGetProxyUpdat
eOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIGetProxyDataF
orRegister
APIGetProxyDataF
orRemove
APIProxyActivateR
egisterExecute
APIProxyActivateR
egisterFix
APIProxyActivateR
emoveExecute
APIGetProxyDataF
orRegister
APIGetProxyDataF
orRemove
APIProxyActivateR
egisterExecute
APIProxyActivateR
egisterFix
APIGetProxyDataF
orRegister
APIProxyActivateR
egisterExecute
APIProxyActivateR
emoveExecute
APIProxyActivateR
egisterFix
APIGetProxyDataF
orRegister
APIGetProxyDataF
orRemove
APIProxyActivateR
egisterExecute

NoDataInProxydatafile137

代理認証データファイルにデータが存在しません。

IncorrectProxyData138

代理認証データファイルの内容が不正です。

FailedReadProxydata

139

代理認証データの読み込みに失敗しました。

FailedToWriteProxyData

140

FailedWithEncryption

141

弊社のデータベースには正常に登録されましたが、代理認証データの書き込みが失敗しました。
弊社のデータベースの登録を解除した上で、再度、当処理を実行していただく必要がありますので弊社までご連絡ください。
暗号化で失敗しました。
APIProxyActivateR
egisterExecute
APIProxyActivateR「認証レスキュー！.NET」 ユーザーズガイド- 161 -

ProxyDataInconsistency

142

egisterPrepare
APIProxyActivateR
emoveExecute
APIProxyActivateR
emovePrepare
APIWriteProxyServ
erInfoToRegistry
APIPreparationOfP
roxyUpdateOfExpirationDate
APIGetProxyUpdat
eOfExpirationDate「代理認証データ」と現在お使いの PC APIProxyActivateRの内容が異なるので確定処理が実行 egisterFix
できません。
APIProxyActivateR
egisterExecute
APIGetProxyDataFor
Register

欠番
AlreadyUsedProxyData

143
144

FailToRegisterConfirm

145

FailToRegisterPreparation

146

UnableToWriteProxyData

147

ThePathHasNotBeenSet

148

PathNotFound

149

EmptyAnyOfTheInputData

150

FailedToRemoveFromRegi

151

この代理認証データファイルは、過去 APIProxyActivateRに使用されているので登録に利用で egisterFix
きません。
登録確定に失敗しました。
APIProxyActivateR
egisterFix
登録準備に失敗しました。
APIProxyActivateR
egisterPrepare
弊社のデータベースには正常に解除 APIProxyActivateRされましたが、代理認証データの書き emoveExecute
込みが失敗しました。
「認証解除/電話」でお客様の PC での認証解除を実行していただく必要がありますので弊社までご連絡ください。
パスが設定されていません。
APIProxyActivateR
egisterPrepare
APIProxyActivateR
emovePrepare
APIPreparationOfP
roxyUpdateOfExpirationDate
設定されたパスが存在しません。
APIProxyActivateR
egisterPrepare
APIProxyActivateR
emovePrepare
APIPreparationOfP
roxyUpdateOfExpirationDate
この PC は認証登録されていません。 APIProxyActivateR
emovePrepare
お客様の PC での認証解除準備が失 APIProxyActivateR「認証レスキュー！.NET」 ユーザーズガイド- 162 -

storyFailedToDeauthenticationP
reparation
NotRestoreException

152

PleasePerformTheDeautho
rizeProcess

154

FailedToDeauthorizeRecov
ery

155

ProductIDIsEmpty

156

SerialNoIsEmpty

157

FailedToRestoreActivation

158

InputDataNotFound

159

欠番
欠番
InvalidUseOfMACAdressOr
CPU

160
161
162

FailedToUpdateTheExpirati
onDate163

CanNotUseTheString

164

153

敗しました。
再度、当処理を実行してください。
解除準備が失敗しました。

emovePrepare

APIProxyActivateR
emovePrepare
何らかの原因で回復できませんでし
APIRestoreCancel
た。
Status
APIRestoreRegisterStatus
弊社のデータベースにもデータが存 APIRestoreCancel
在しますので当処理ではなく、「認証 Status
解除」処理を行ってください。
お客様の PC で認証解除の回復に失 APIRestoreCancel
敗しました。
Status「認証解除/電話」でお客様の PC での認証解除を実行していただく必要がありますので弊社までご連絡ください。
プロダクト ID を入力してください。
APIRestoreRegisterStatus
シリアル No.を入力してください。
APIRestoreRegisterStatus
お客様の PC で認証登録の回復に失 APIRestoreRegiste
敗しました。
rStatus
弊社のデータベースの登録を解除した上で、再度、認証登録を実行していただく必要がありますので弊社までご連絡ください。
入力された「プロダクト ID」や「シリア APIRestoreRegiste
ル No.」、PC 情報などが弊社のデータ rStatus
ベースに登録されていません。
APIActivateStatus
弊社のデータベースの登録を解除し OnlineVerify
た上で、再度、認証登録を実行していただく必要がありますので弊社までご連絡ください。
旧レンタル機能関連
旧レンタル機能関連
MAC アドレスか CPU 情報の使用が無 APIRestoreRegiste
効 な た め こ の 処理 は 実行 で き ませ rStatusん。
弊社までご連絡ください。
「有効期限」の更新に失敗しました。
APIUpdateOfExpira
tionDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
使用できない文字列が含まれていま
APIActivateRegist
す。
erInternet
APIActivateRemoveInternet
APIProxyActivateR「認証レスキュー！.NET」 ユーザーズガイド- 163 -

PropertyValueNotFound

165「必須設定プロパティ」に値が設定されていません。

egisterExecute
APIProxyActivateR
emoveExecute
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetProductIdS
erialNoList
APIGetFreeItem
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus
OnlineVerify
APIActivateRegist
erInternet
APIGetRegisteredI
nfoFromRegistry
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIActivateStatus
Check
APIActivateStatus
CheckOnline
APIGenerationOfN
ewCertificationID
APIGetProxyDataF
orRemove
APIProxyActivateR
egisterExecute
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare「認証レスキュー！.NET」 ユーザーズガイド- 164 -

APIProxyActivateR
emoveExecute
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetProductIdS
erialNoList
APIGetFreeItem
APITrialStartDate
Remove
APIRunNR2AppDat
eRemove
APIRunNR2AppDat
eRemove2
APIActivateStatus
Check2
APIGetRegisteredI
nfoFromRegistry2
APIActivateStatus
CheckOnline2
APIGetProxyDataF
orRegister
APIWriteProxyServ
erInfoToRegistry
APIReadProxyServ
erInfoFromRegistry
APIGetRegisteredI
nfoFromWeb
APIPreparationOfP
roxyUpdateOfExpirationDate
APIGetProxyDataF
orExpirationDate
APIGetProxyUpdat
eOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Finish「認証レスキュー！.NET」 ユーザーズガイド- 165 -

NotUpdateTheExpirationD
ate

166

新しい有効期限が同じか古い場合「更新しない」ように設定されているので更新されませんでした。

CanNotReadTheTrialStart
Day

167

日付データの取得に失敗しました。
（猶予）

欠番

168

旧レンタル機能関連

APIActivateStatus
OnlineVerify
APIUpdateOfExpira
tionDate
APIGetProxyUpdat
eOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIGenerationOfN
ewCertificationID
APIGetRegisteredI
nfoFromRegistry
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus
OnlineVerify「認証レスキュー！.NET」 ユーザーズガイド- 166 -

CanNotReadTheExpiration
StartDate169

日付データの取得に失敗しました。
（有効期限）

APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIGenerationOfN
ewCertificationID
APIGetProxyDataF
orRegister
APIGetRegisteredI
nfoFromRegistry
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIProxyActivateR
egisterExecute
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIPreparationOfP
roxyUpdateOfExpirationDate
APIGetProxyDataF
orExpirationDate
APIGetProxyUpdat
eOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus
OnlineVerify「認証レスキュー！.NET」 ユーザーズガイド- 167 -

CanNotReadProxyServerIn
foFromRegistry
CanNotWriteProxyServerIn
foToRegistry
ExternalLinkKeyNotFound

170

FailToGetRegisterInfo

173

プロキシサーバー情報の読み込みに失敗しました。
プロキシサーバー情報の書き込みに失敗しました。
指定されたリンク用キーは弊社データ
ベースに登録されていません。
認証情報の取得に失敗しました。

PCDateChanged

174

PC の日付が変更されました。

ProxyExpirationDateDataFi
leNotFound175

代理有効期限取得データファイルが存在しません。

171
172

APIReadProxyServ
erInfoFromRegistry
APIWriteProxyServ
erInfoToRegistry
APIGetProductIdS
erialNoList
APIPreparationOfP
roxyUpdateOfExpirationDate
APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIGenerationOfN
ewCertificationID
APIGetRegisteredI
nfoFromRegistry
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIGetProxyDataF
orExpirationDate
APIGetProxyUpdat「認証レスキュー！.NET」 ユーザーズガイド- 168 -

NoDataInProxyExpirationD
ateDataFile

176

代理有効期限取得データファイルにデータが存在しません。

FailedReadProxyExpiration
DateData

177

代理有効期限取得データの読み込みに失敗しました。

FailedToWriteProxyExpirati
onDateData

178

NoExpirationDateSettingF
orProxyExpirationDateDataFile
HardwareInfoAndProxyExp
irationDateDataIsMismatch

179

代理有効期限取得データの書き込みが失敗しました。
もう一度、「代理有効期限取得準備(認証 PC)」から行ってください。
代理有効期限取得データは有効期限の利用設定はありません。

180「代理有効期限取得データ」と現在お使いの PC の内容が一致しません。

FailedRemoveValueFromR
egistory181

削除処理が失敗しました。（レジストリ）

FailedRemoveValueFromF
older
FailedReadRunAppDateVal
ueFromRegistory

182

削除処理が失敗しました。（フォルダ）183「アプリ起動日」の読み込みに失敗しました。（レジストリ）

eOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIGetProxyDataF
orExpirationDate
APIGetProxyUpdat
eOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIGetProxyDataF
orExpirationDate
APIGetProxyUpdat
eOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIGetProxyUpdat
eOfExpirationDate

APIDetermination
OfProxyUpdateOfE
xpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APITrialStartDate
Remove
APIRunNR2AppDat
eRemove
APIRunNR2AppDat
eRemove2
APIRunNR2AppDat
eRemove2
APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIActivateStatus
Check
APIActivateStatus
Check2
APIGenerationOfN
ewCertificationID「認証レスキュー！.NET」 ユーザーズガイド- 169 -

FailedWriteRunAppDateVal
ueFromRegistory

184「アプリ起動日」の書き込みに失敗しました。（レジストリ）

APIGetRegisteredI
nfoFromRegistry
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIActivateStatus
CheckOnline
APIActivateStatus
CheckOnline2
APIGetRegisteredI
nfoFromRegistry2
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus
OnlineVerify
APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIActivateStatus
Check
APIActivateStatus
Check2
APIGenerationOfN
ewCertificationID「認証レスキュー！.NET」 ユーザーズガイド- 170 -

FailedReadRunAppDateVal
ueFromFolder

185「アプリ起動日」の読み込みに失敗しました。（フォルダ）

APIGetRegisteredI
nfoFromRegistry
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIActivateStatus
CheckOnline
APIActivateStatus
CheckOnline2
APIGetRegisteredI
nfoFromRegistry2
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus
OnlineVerify
APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIActivateStatus
Check
APIActivateStatus
Check2
APIGenerationOfN
ewCertificationID「認証レスキュー！.NET」 ユーザーズガイド- 171 -

FailedWriteRunAppDateVal
ueFromFolder
ProductIDAndSerialNoIsFl
oatingLicense

186
187

「アプリ起動日」の書き込みに失敗しました。（フォルダ）
そのプロダクト ID + シリアル No.は、フローティングライセンスのため、この処理は無効です。

ReturnValueNotFound

188

メソッドの値が見つかりません。

APIGetRegisteredI
nfoFromRegistry
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIActivateStatus
CheckOnline
APIActivateStatus
CheckOnline2
APIGetRegisteredI
nfoFromRegistry2
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus
OnlineVerify
APIActivateStatus
Check2
APIActivateRegist
erInternet
APIProxyActivateR
egisterExecute
APIRestoreRegisterStatus
APIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIProxyActivateR
egisterExecute「認証レスキュー！.NET」 ユーザーズガイド- 172 -

CanNotUseWithTrial

189

猶予（試用）でご利用の場合は、この処理はできません。

FailedReadRegistorydata

190

レジストリデータの読み込みで失敗しました。

APIProxyActivateR
emoveExecute
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetProductIdS
erialNoList
APIGetFreeItem
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus
CheckOnline
APIActivateStatus
CheckOnline2
APIActivateStatus
OnlineVerify
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateRemoveInternet
APIProxyActivateR
emovePrepare
APIUpdateOfExpira
tionDate
APIPreparationOfP
roxyUpdateOfExpirationDate
APIDetermination
OfProxyUpdateOfE
xpirationDate
APIFloatingLicense「認証レスキュー！.NET」 ユーザーズガイド- 173 -

AlreadyFloatingLicenseReg
istered191

フローティングライセンス登録済のため、この処理は無効です。

FloatingLicenseRegistratio
nFailed
CanNotUseFloatingLicense

192

FloatingLicenseUnauthenti
catedByTrialPeriodOut

194

フローティングライセンス登録が失敗しました。
指定されたプロダクト ID とシリアル№
は、フローティングライセンスは使用できません。
フローティングライセンス登録されていないため、この処理は無効です。

FloatingLicenseUnauthenti
catedByTrialPeriod

195

フローティングライセンス登録されていないため、この処理は無効です。

FloatingLicenseUnauthenti
cated

196

フローティングライセンス登録されていないため、この処理は無効です。

193

CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateRegist
erInternet
APIActivateRegist
erTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIGenerationOfN
ewCertificationID
APIProxyActivateR
egisterFix
APIProxyActivateR
egisterPrepare
APIProxyActivateR
emovePrepare
APIRestoreCancel
Status
APIRestoreRegisterStatus
APIFloatingLicense
Register
APIFloatingLicense
Register
APIFloatingLicense
Register
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Finish
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Finish
APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Finish「認証レスキュー！.NET」 ユーザーズガイド- 174 -

FloatingLicenseInUse

197

FloatingLicenseCancellatio
nFailedExpirationDateHasExpired

198

AlreadyFloatingLicenseSta
rted
LicenseKeyIsDifferent

200

ExpirationDateIsDifferent

202

FailedToCancelFloatingLic
ense
FailedToStartFloatingLicense
FloatingLicenseNotStarted

203

RegisteredProductIDAndS
erialNoIsNotFound

206

FailedToFinishFloatingLice
nse
FailedToRegisterFloatingLi
cense
ErrorCallingWebServiceMe
thod

207

199

201

204
205

208
209

フローティングライセンス終了処理を行ってから再度、当処理を実行してください。
フローティングライセンス解除が失敗しました。
有効期限が切れているため、この処理は無効です。
既にフローティングライセンスが開始されています。
フローティングライセンスで登録した「ライセンスキー」がデータベースと違います。フローティングライセンス解除を行い、もう一度フローティングライセ
ンス登録を行ってからこの処理を行ってください。
フローティングライセンスで登録した「有効期限」がデータベースと違います。フローティングライセンス解除を行い、もう一度フローティングライセンス登録を行ってからこの処理を行ってください。
何らかの原因でフローティングライセ
ンスを解除できませんでした。
何らかの原因でフローティングライセ
ンスを開始できませんでした。
フローティングライセンスが開始されていないため、この処理は無効です。
レジストリに登録されているプロダクト
ID+シリアル No.に該当する認証キー
データが存在しません。
何らかの原因でフローティングライセ
ンスを終了できませんでした。
何らかの原因でフローティングライセ
ンスを登録できませんでした。
Web サービスのメソッド呼び出しでエラーが発生しました。

APIFloatingLicense
CancelAPIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
Start
APIFloatingLicense
Start

APIFloatingLicense
Start

APIFloatingLicense
CancelAPIFloatingLicense
Start
APIFloatingLicense
FinishAPIActivateStatus
OnlineVerify
APIFloatingLicense
Finish
APIFloatingLicense
Register
APIActivateRegist
erInternet
APIActivateRemoveInternet
APIProxyActivateR
egisterExecute
APIProxyActivateR
emoveExecute
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetProductIdS
erialNoList「認証レスキュー！.NET」 ユーザーズガイド- 175 -

ErrorInWebServiceMethod

210

ProxyServerConnectionFai
led

211

Web サービスのメソッド内でエラーが発生しました。
プロキシサーバーの接続に失敗しました。

APIGetFreeItem
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
Start
APIFloatingLicense
Finish
APIFloatingLicense
CancelAPIActivateStatus
OnlineVerify
APIActivateStatus
CheckOnline
APIActivateStatus
CheckOnline2
APIActivateStatus
OnlineVerify
APIActivateRegist
erInternet
APIActivateRemoveInternet
APIProxyActivateR
egisterExecute
APIProxyActivateR
emoveExecute
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetProductIdS
erialNoList
APIGetFreeItem
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
Start
APIFloatingLicense
Finish
APIFloatingLicense
Cancel「認証レスキュー！.NET」 ユーザーズガイド- 176 -

ServerConnectionFailed212

サーバーの接続に失敗しました。

9999

その他エラー

APIActivateStatus
CheckOnline
APIActivateStatus
CheckOnline2
APIActivateStatus
OnlineVerify
APIActivateRegist
erInternet
APIActivateRemoveInternet
APIProxyActivateR
egisterExecute
APIProxyActivateR
emoveExecute
APIRestoreCancel
Status
APIRestoreRegisterStatusAPIUpdateOfExpira
tionDate
APIGetProductIdS
erialNoList
APIGetFreeItem
APIGetRegisteredI
nfoFromWeb
APIGetProxyUpdat
eOfExpirationDate
APIFloatingLicense
Register
APIFloatingLicense
Start
APIFloatingLicense
Finish
APIFloatingLicense
CancelAPIActivateStatus
CheckOnline
APIActivateStatus
CheckOnline2
APIActivateStatus
OnlineVerify「認証レスキュー！.NET」 ユーザーズガイド- 177 -

APICertificationID プロパティ【機能】
認証 ID を取得します。（取得専用）【構文】<VB.NET>
Public Property APICertificationID As String<C#>public string APICertificationID { get; }【解説】
認証 ID を取得します。（取得専用）
次のメソッドを実行すると当プロパティ（APICertificationID プロパティ）に（）内の各値が設定されます。
・APIGenerationOfNewCertificationID メソッド（新しく生成された認証 ID）
・APIGetRegisteredInfoFromRegistry メソッド（認証登録済みの認証 ID）
・APIGetProxyDataForRegister メソッド（代理認証登録データから取得した認証 ID）
・APIGetProxyDataForRemove メソッド（代理認証解除データから取得した認証 ID）「認証レスキュー！.NET」 ユーザーズガイド- 178 -

APICurrentExpirationDate プロパティ【機能】現在の有効期限を取得します。（取得専用）【構文】<VB.NET>
Public Property APICurrentExpirationDate As String<C#>public string APICurrentExpirationDate { get; }【解説】
現在の有効期限を取得します。（取得専用）
次のメソッドの成功時のみ、当プロパティに値が設定されます。
・APIGetRegisteredInfoFromRegistry メソッド（レジストリからの証登録済み情報の取得）
当プロパティの値を利用するメソッドは次の通りです。
・APIUpdateOfExpirationDate メソッド（「有効期限の更新」を実行）「認証レスキュー！.NET」 ユーザーズガイド- 179 -

APIDisabledNICIgnore プロパティ【機能】
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
デフォルト：True。
【構文】<VB.NET>
Public Property APIDisabledNICIgnore As Boolean<C#>public bool APIDisabledNICIgnore { set; get; }【解説】
認証レスキュー！の認証 UI ライブラリでは、認証登録など各処理時にエンドユーザ PC の MAC アド
レスを最大で 5 個記録します。MAC アドレスは LAN ポートなどのネットワーク機器に固有な物理アドレスです。
このプロパティが False の場合、無効になっている NIC を一度有効にし、情報を取得後に再度 NICを無効にします。この際に少し時間が掛かります。
このプロパティを True に設定すると、この無効の NIC は無視し、有効の NIC のみ情報を取得して記録します。これにより、情報の取得が高速化します。
認証レスキュー！の各処理では、最初に認証状況を確認しており、認証済みの場合、記録されている情報と、使用されている PC 情報が合致しているか確認しています。
このプロパティを True に設定することで、各処理が高速化します。
＜ご注意＞
たとえば、エンドユーザ PC の NIC が 2 つ有効で 3 つが無効の状態とします。
ＭＡＣアドレスの例：①A11111111111 → NIC が有効②B22222222222 → NIC が有効③C33333333333 → NIC が無効④D44444444444 → NIC が無効⑤E55555555555 → NIC が無効
このプロパティが False の場合、5 個の MAC アドレスを取得するために、2 つ有効（①②）になっている MAC アドレスと、3 つの無効（③④⑤）の NIC を一度有効にし、MAC アドレスを取得後に再度無効に設定します。
この無効の NIC を有効にし、再度無効にすることで、少々時間が掛かります。
このプロパティが True の場合、この 3 つの無効の NIC は無視し、2 つの有効な MAC アドレスのみ取得します。これにより、ＭＡＣアドレスの取得時間が短縮されます。
しかし、次の点にご注意ください。
たとえば、このプロパティが True で、2 つの有効な（①②）になっている MAC アドレスで認証登録をします。
次に、2 つの有効な（①②）NIC を無効にし、3 つの無効な（③④⑤）を有効にして認証解除は、MAC
アドレスが一致しないため「-999：認証済みハードウエア情報不一致」となり実行できません。

「認証レスキュー！.NET」 ユーザーズガイド- 180 -

APIEncryptionPassword プロパティ【機能】
暗号化時のパスワードを設定します。
【構文】<VB.NET>
Public Property APIEncryptionPassword As String<C#>public string APIEncryptionPassword { set; get; }【解説】
認証 UI ライブラリ（DLL）はエンドユーザ PC のレジストリやファイルにデータを出力する際に必要に応じてデータを暗号化しています。その際の暗号化の方法は貴社では指定できませんが、暗号化する時の 2 つのパラメータ、パスワードと Salt 文字列は貴社で指定できます。
当プロパティには暗号化時のパスワードを指定します。全角でも指定できます。
（例）"認証レスキュー！"
当プロパティの文字数は、空文字列は不可で 1～65535 文字ですが、8 文字から 15 文字程度が妥当と思われます。

「認証レスキュー！.NET」 ユーザーズガイド- 181 -

APIEncryptionSaltString プロパティ【機能】
暗号化時の Salt 文字列（8 文字以上）を設定します。
【構文】<VB.NET>
Public Property APIEncryptionSaltString As String<C#>public string APIEncryptionSaltString { set; get; }【解説】
認証 UI ライブラリ（DLL）はエンドユーザ PC のレジストリやファイルにデータを出力する際に必要に応じてデータを暗号化しています。その際の暗号化の方法は貴社では指定できませんが、暗号化する時の 2 つのパラメータ、パスワードと Salt 文字列は貴社で指定できます。
当プロパティには暗号化時の Salt 文字列を指定します。
必ず 8 文字以上で指定します。
（例）"12345678ABCDEFGH"「認証レスキュー！.NET」 ユーザーズガイド- 182 -

APIErrorStatus プロパティ【機能】
カスタム UI 系のメソッドを使用した際のエラーの内容を返します。
【構文】<VB.NET>
Public ReadOnly Property APIErrorStatus As Integer<C#>public int APIErrorStatus { get; }【解説】
カスタム UI 系のメソッドは戻り値として正常（True）かエラー（False）を返しますが、この APIErrorStat
us プロパティはそのエラーの内容を APIError 列挙体の参照で返します。この APIErrorStatus プロパ
ティは取得専用です。

「認証レスキュー！.NET」 ユーザーズガイド- 183 -

APIExternalLinkKey プロパティ【機能】
APIGetProductIdSerialNoList メソッド 実行時の外部データベースとのリンク用キー項目を設定します。
【構文】<VB.NET>
Public Property APIExternalLinkKey As String<C#>public string APIExternalLinkKey { set; get; }【解説】
認証レスキュー！の ActivationKey テーブルよりプロダクト ID とシリアル No.のペア文字列の列挙を取得する APIGetProductIdSerialNoList メソッドの実行時に、外部データベースとのリンク用キー項
目を当プロパティ（APIExternalLinkKey プロパティ）設定します。
認証レスキュー！とは別の外部データベースとのリンク用キーを当プロパティ（APIExternalLinkKey
プロパティ）に設定し、APIGetProductIdSerialNoList メソッドを実行すると、認証レスキュー！のデータベースの ActivationKey テーブルより該当するプロダクト ID とシリアル No.のペア文字列の列挙
をデリミタ付きで APIProductIdSerialNoList プロパティに設定して返します。

「認証レスキュー！.NET」 ユーザーズガイド- 184 -

APINewExpirationDate プロパティ【機能】
新しい有効期限を取得します。（取得専用）【構文】<VB.NET>
Public Property APINewExpirationDate As String<C#>public string APINewExpirationDate { get; }【解説】
新しい有効期限を取得します。（取得専用）
次のメソッドの成功時のみ、当プロパティに値が設定されます。
・APIGetProxyDataForExpirationDate メソッド（代理有効期限取得データの取得）
・APIGetProxyUpdateOfExpirationDate メソッド（「代理有効期限/取得」を実行（代理 PC で利用））
当プロパティの値を利用するメソッドは次の通りです。
・APIDeterminationOfProxyUpdateOfExpirationDate メソッド（「代理有効期限更新/確定」を実行）「認証レスキュー！.NET」 ユーザーズガイド- 185 -

APIFloatingLicenseDataInfo プロパティ【機能】
フローティングライセンス使用中の PC 一覧を文字列として取得します。（取得専用）【構文】<VB.NET>
Public Property APIFloatingLicenseDataInfo As String<C#>public string APIFloatingLicenseDataInfo { get; }【解説】フローティングライセンス登録されている「プロダクト ID」と「シリアル No.」に該当する、使用中の PC
一覧を文字列として取得します。（取得専用）
文字列は、「PC 名」 デリミタのカンマ（，） 「認証 ID」として設定されます。
（例）"PCName1,50533-21818,PCName2,17958-26503,PCName3,78359-54685"
次のメソッドの成功時のみ、当プロパティに値が設定されます。
・APIActivateStatusOnlineVerify メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 186 -

APIFloatingLicenseMaxCount プロパティ【機能】
フローティングライセンスの最大ライセンス数を取得します。（取得専用）【構文】<VB.NET>
Public ReadOnly Property APIFloatingLicenseMaxCount As Integer<C#>public int APIFloatingLicenseMaxCount { get; }【解説】フローティングライセンスの最大ライセンス数を取得します。（取得専用）
最大ライセンス数とは、レジストリからのフローティングライセンス登録済情報に該当する認証キー
テーブルのプロダクト ID とシリアル No.に設定されている「ライセンス数」と「プラス許可数」を足した数です。
次のメソッドの成功時のみ、当プロパティに値が設定されます。
・APIActivateStatusOnlineVerify メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 187 -

APIFloatingLicenseState プロパティ【機能】
フローティングライセンス状況（0：未登録 1：登録済 2：使用中）を取得します。（取得専用）【構文】<VB.NET>
Public ReadOnly Property APIFloatingLicenseState As Byte<C#>public byte APIFloatingLicenseState { get; }【解説】フローティングライセンス状況（0：未登録 1：登録済 2：使用中）を取得します。（取得専用）
次のメソッドの成功時のみ、当プロパティに値が設定されます。
・APIActivateStatusOnlineVerify メソッド(0：未登録 1：登録済 2：使用中)・APIGetRegisteredInfoFromRegistry メソッド(0：未登録 1：登録済)
APIActivateStatusOnlineVerify メソッドは、オンラインで貴社のデータベースに接続しフローティング
ライセンスが使用中かどうか確認しているのに対し、APIGetRegisteredInfoFromRegistry メソッドは、
レジストリ情報のみの確認ですので「2：使用中」は返しません。

「認証レスキュー！.NET」 ユーザーズガイド- 188 -

APIFloatingLicenseUsedCount プロパティ【機能】
フローティングライセンスのライセンス使用数を取得します。（取得専用）【構文】<VB.NET>
Public ReadOnly Property APIFloatingLicenseUsedCount As Integer<C#>public int APIFloatingLicenseUsedCount { get; }【解説】フローティングライセンスの使用数を取得します。（取得専用）
使用数とは、フローティングライセンスの最大ライセンス数（APIFloatingLicenseMaxCount プロパティ）のうち、いくつ使用されているかの数です。
次のメソッドの成功時のみ、当プロパティに値が設定されます。
・APIActivateStatusOnlineVerify メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 189 -

APIFreeItem1～5 プロパティ【機能】
APIGetFreeItem メソッドを実行して ActivationKey テーブルより取得した自由入力項目の値が当プ
ロパティ（APIFreeItem1～APIFreeItem5 プロパティ）に設定されます。（取得専用）【構文】<VB.NET>
Public Property APIFreeItem1 As String
Public Property APIFreeItem2 As String
Public Property APIFreeItem3 As String
Public Property APIFreeItem4 As String
Public Property APIFreeItem5 As String<C#>public string APIFreeItem1 { get; }public string APIFreeItem2 { get; }public string APIFreeItem3 { get; }public string APIFreeItem4 { get; }public string APIFreeItem5 { get; }【解説】
APIGetFreeItem メソッドを実行して ActivationKey テーブルより取得した自由入力項目の値が当プ
ロパティ（APIFreeItem1～APIFreeItem5 プロパティ）に設定されます。

「認証レスキュー！.NET」 ユーザーズガイド- 190 -

APILicenseKey プロパティ【機能】ライセンスキーを設定・取得します。
【構文】<VB.NET>
Public Property APILicenseKey As String<C#>public string APILicenseKey { set; get; }【解説】
ライセンスキーを設定・取得します。
次のメソッドを実行すると当プロパティ（APILicenseKey プロパティ）に（）内の値が設定されます。
・APIGetRegisteredInfoFromRegistry メソッド（認証登録済みのライセンスキー）「認証レスキュー！.NET」 ユーザーズガイド- 191 -

APIOverwriteModeOfExpirationDateUpdate プロパティ【機能】「有効期限の更新」（APIUpdateOfExpirationDate）メソッドを実行する際に、データベース上の新しい
有効期限が現在のエンドユーザ PC のレジストリ内有効期限が同じか古い場合の対応を設定します。
【構文】<VB.NET>
Public Property APIOverwriteModeOfExpirationDateUpdate As Boolean<C#>public bool APIOverwriteModeOfExpirationDateUpdate { set; get; }【解説】
当プロパティには次のいづれか値を設定します。
True：新しい有効期限が現在と同じか古い場合でも更新します。
False：新しい有効期限が現在と同じか古い場合は更新しません。
「有効期限の更新」の実行については、APIUpdateOfExpirationDate メソッドをご覧ください。

「認証レスキュー！.NET」 ユーザーズガイド- 192 -

APIProductID プロパティ【機能】
プロダクト ID を設定・取得します。
【構文】<VB.NET>
Public Property APIProductID As String<C#>public string APIProductID { set; get; }【解説】
プロダクト ID を設定・取得します。
次のメソッドを実行すると当プロパティ（APIProductID プロパティ）に（）内の各値が設定されます。
・APIGetRegisteredInfoFromRegistry メソッド（認証登録済みのプロダクト ID）
・APIGetProxyDataForRegister メソッド（代理認証登録データから取得したプロダクト ID）
・APIGetProxyDataForRemove メソッド（代理認証解除データから取得したプロダクト ID）「認証レスキュー！.NET」 ユーザーズガイド- 193 -

APIProductIdSerialNoList プロパティ【機能】
APIGetProductIdSerialNoList メソッド実行後にプロダクト ID とシリアル No.のペアをデリミタで列挙したの文字列が設定されます。（取得専用）【構文】<VB.NET>
Public Property APIProductIdSerialNoList As String<C#>public string APIProductIdSerialNoList { get; }【解説】
APIGetProductIdSerialNoList メソッド実行後にプロダクト ID とシリアル No.のペアをデリミタで列挙した文字列が当プロパティ（APIProductIdSerialNoList プロパティ）設定されます。
認証レスキュー！とは別の外部データベースとのリンク用キーを APIExternalLinkKey プロパティに設定し、APIGetProductIdSerialNoList メソッドを実行すると、認証レスキュー！のデータベースの A
ctivationKey テーブルより該当するプロダクト ID とシリアル No.のペア文字列の列挙をデリミタ付きで
当プロパティ（APIProductIdSerialNoList プロパティ）に設定して返します。
プロダクト ID とシリアル No.のペア文字列の列挙は、たとえば次のような文字列です。
デリミタはカンマ（，）です。
1111-1111-1111,aaaa1111,22222-22222-22222,bbbb2222,33333-33333-33333,cccc3333
この例では次の 3 組のプロダクト ID とシリアル No.が返されました。
プロダクト ID =”11111-11111-11111” シリアル No.=”aaaa1111”
プロダクト ID =”22222-22222-22222” シリアル No.=”bbbb2222”
プロダクト ID =”33333-33333-33333” シリアル No.=”cccc3333”「認証レスキュー！.NET」 ユーザーズガイド- 194 -

APIProxyDataPath プロパティ【機能】
代理認証データパスを設定・取得します。
（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Property APIProxyDataPath As String<C#>public string APIProxyDataPath { set; get; }【解説】
代理認証データパスを設定・取得します。ファイルの拡張子は「.NRS」とします。
当プロパティを利用するメソッドは次の通りです。
・APIGetProxyDataForRegister メソッド（代理認証登録データの取得）
・APIGetProxyDataForRemove メソッド（代理認証解除データの取得）
・APIProxyActivateRegisterExecute メソッド（代理認証登録/実行）・APIProxyActivateRegisterFix メソッド（代理認証登録/確定）
・APIProxyActivateRegisterPrepare メソッド（代理認証登録/準備）・APIProxyActivateRemoveExecute メソッド（代理認証解除/実行）・APIProxyActivateRemovePrepare メソッド（代理認証解除/準備）「認証レスキュー！.NET」 ユーザーズガイド- 195 -

APIProxyServerAddress プロパティ【機能】
プロキシサーバーのアドレスを設定します。
【構文】<VB.NET>
Public Property APIProxyServerAddress As String<C#>public string APIProxyServerAddress { set; get; }【解説】
プロキシサーバーのアドレスを設定します。
インターネットに接続する際にプロキシサーバーを使用する場合のみ設定が必要です。
プロキシサーバーを使用する場合は、当プロパティを含む次のプロパティに適切な設定が必要です。
・APIProxyServerAddress プロパティ（プロキシサーバーのアドレス）→当プロパティ
・APIProxyServerPort プロパティ（プロキシサーバーのポート）
・APIProxyServerUserName プロパティ（プロキシサーバーのユーザ名）
・APIProxyServerPassword プロパティ（プロキシサーバーのパスワード）
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIActivateRegisterInternet メソッド（インターネットによる認証登録を実行）
・APIActivateRemoveInternet メソッド（インターネットによる認証解除を実行）
・APIProxyActivateRegisterExecute メソッド（代理認証登録/実行）・APIProxyActivateRemoveExecute メソッド（代理認証解除/実行）・APIRestoreRegisterStatus メソッド（認証登録状態回復）
・APIRestoreCancelStatus メソッド（認証解除状態回復）
・APIUpdateOfExpirationDate メソッド（有効期限の更新）「認証レスキュー！.NET」 ユーザーズガイド- 196 -

APIProxyServerPassword プロパティ【機能】
プロキシサーバーのパスワードを設定します。
【構文】<VB.NET>
Public Property APIProxyServerPassword As String<C#>public string APIProxyServerPassword { set; get; }【解説】
プロキシサーバーのパスワードを設定します。
インターネットに接続する際にプロキシサーバーを使用する場合のみ設定が必要です。
プロキシサーバーを使用する場合は、当プロパティを含む次のプロパティに適切な設定が必要です。
・APIProxyServerAddress プロパティ（プロキシサーバーのアドレス）
・APIProxyServerPort プロパティ（プロキシサーバーのポート）
・APIProxyServerUserName プロパティ（プロキシサーバーのユーザ名）
・APIProxyServerPassword プロパティ（プロキシサーバーのパスワード）→当プロパティ
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIActivateRegisterInternet メソッド（インターネットによる認証登録を実行）
・APIActivateRemoveInternet メソッド（インターネットによる認証解除を実行）
・APIProxyActivateRegisterExecute メソッド（代理認証登録/実行）・APIProxyActivateRemoveExecute メソッド（代理認証解除/実行）・APIRestoreRegisterStatus メソッド（認証登録状態回復）
・APIRestoreCancelStatus メソッド（認証解除状態回復）
・APIUpdateOfExpirationDate メソッド（有効期限の更新）「認証レスキュー！.NET」 ユーザーズガイド- 197 -

APIProxyServerPort プロパティ【機能】
プロキシサーバーのポートを設定します。
【構文】<VB.NET>
Public Property APIProxyServerPort As String<C#>public string APIProxyServerPort { set; get; }【解説】
プロキシサーバーのポートを設定します。
インターネットに接続する際にプロキシサーバーを使用する場合のみ設定が必要です。
プロキシサーバーを使用する場合は、当プロパティを含む次のプロパティに適切な設定が必要です。
・APIProxyServerAddress プロパティ（プロキシサーバーのアドレス）
・APIProxyServerPort プロパティ（プロキシサーバーのポート）→当プロパティ
・APIProxyServerUserName プロパティ（プロキシサーバーのユーザ名）
・APIProxyServerPassword プロパティ（プロキシサーバーのパスワード）
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIActivateRegisterInternet メソッド（インターネットによる認証登録を実行）
・APIActivateRemoveInternet メソッド（インターネットによる認証解除を実行）
・APIProxyActivateRegisterExecute メソッド（代理認証登録/実行）・APIProxyActivateRemoveExecute メソッド（代理認証解除/実行）・APIRestoreRegisterStatus メソッド（認証登録状態回復）
・APIRestoreCancelStatus メソッド（認証解除状態回復）
・APIUpdateOfExpirationDate メソッド（有効期限の更新）「認証レスキュー！.NET」 ユーザーズガイド- 198 -

APIProxyServerUserName プロパティ【機能】
プロキシサーバーのユーザ名を設定します。
【構文】<VB.NET>
Public Property APIProxyServerUserName As String<C#>public string APIProxyServerUserName { set; get; }【解説】
プロキシサーバーのユーザ名を設定します。
インターネットに接続する際にプロキシサーバーを使用する場合のみ設定が必要です。
プロキシサーバーを使用する場合は、当プロパティを含む次のプロパティに適切な設定が必要です。
・APIProxyServerAddress プロパティ（プロキシサーバーのアドレス）
・APIProxyServerPort プロパティ（プロキシサーバーのポート）
・APIProxyServerUserName プロパティ（プロキシサーバーのユーザ名）→当プロパティ
・APIProxyServerPassword プロパティ（プロキシサーバーのパスワード）
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIActivateRegisterInternet メソッド（インターネットによる認証登録を実行）
・APIActivateRemoveInternet メソッド（インターネットによる認証解除を実行）
・APIProxyActivateRegisterExecute メソッド（代理認証登録/実行）・APIProxyActivateRemoveExecute メソッド（代理認証解除/実行）・APIRestoreRegisterStatus メソッド（認証登録状態回復）
・APIRestoreCancelStatus メソッド（認証解除状態回復）
・APIUpdateOfExpirationDate メソッド（有効期限の更新）「認証レスキュー！.NET」 ユーザーズガイド- 199 -APIReleaseKey プロパティ【機能】
解除キーを設定・取得します。
【構文】<VB.NET>
Public Property APIReleaseKey As String<C#>public string APIReleaseKey { set; get; }【解説】
解除キーを設定・取得します。
当プロパティは、電話による認証解除メソッド（APIActivateRemoveTelephone メソッド）で使用します。
解除キーは通常、たとえば"956-11749-60711"といったハイフン付きの数字列です。

「認証レスキュー！.NET」 ユーザーズガイド- 200 -APIReleaseStatus プロパティ【機能】解除ステータスを取得します。（取得専用）【構文】<VB.NET>
Public Property APIReleaseStatus As String<C#>public string APIReleaseStatus { get; }【解説】
解除ステータスを取得します。（取得専用）
当プロパティは、電話による認証解除メソッド（APIActivateRemoveTelephone メソッド）の実行が成功した場合のみ自動的に設定されます。
解除ステータスは通常、たとえば"162-20797-49245"といったハイフン付きの数字列です。

「認証レスキュー！.NET」 ユーザーズガイド- 201 -APISelectRunAppDatePathFlag プロパティ【機能】「アプリ起動日」の読み込み/書き込み場所の切り替えフラグを設定します。
APIActivateStatusCheck2 メソッドと APIActivateStatusCheckOnline2 メソッドで使用されます。
【構文】<VB.NET>
Public Property APISelectRunAppDatePathFlag As Integer<C#>public int APISelectRunAppDatePathFlag { set; get; }【解説】
このプロパティ値により「アプリ起動日」の読み込み/書き込み場所を切り替えます。
0 を指定した場合：HKEY_CURRENT_USER（レジストリ）
1 を指定した場合：ProgramData（フォルダ）
APIActivateStatusCheck2 メソッドと APIActivateStatusCheckOnline2 メソッドで使用されます。

「認証レスキュー！.NET」 ユーザーズガイド- 202 -APISerialNo プロパティ【機能】
シリアル No.を設定・取得します。
【構文】<VB.NET>
Public Property APISerialNo As String<C#>public string APISerialNo { set; get; }【解説】
シリアル No.を設定・取得します。
次のメソッドを実行すると当プロパティ（APIProductID プロパティ）に（）内の各値が設定されます。
・APIGetRegisteredInfoFromRegistry メソッド（認証登録済みのシリアル No.）・APIGetProxyDataForRegister メソッド（代理認証登録データから取得したシリアル No.）・APIGetProxyDataForRemove メソッド（代理認証解除データから取得したシリアル No.）

「認証レスキュー！.NET」 ユーザーズガイド- 203 -

APITrialPeriod プロパティ【機能】猶予（試用）日数（デフォルト：0 日、設定可能範囲：1～365）を設定します。
【構文】<VB.NET>
Public Property APITrialPeriod As Integer<C#>public int APITrialPeriod { set; get; }【解説】
エンドユーザがライセンス認証登録をしなくてもアプリケーションが動作する期間を指定します。
1（日）～365（日）の間で設定できます。
当プロパティを 0 に設定すると、猶予期間は無いことになり、ライセンス認証登録をしない限りアプリ
ケーション（またはアプリケーションの主機能など）が動作しないようにできます。

「認証レスキュー！.NET」 ユーザーズガイド- 204 -

APIUseCpuInfo プロパティ【機能】CPU 情報の使用（デフォルト：True）を設定します。
次の 3 つのメソッドの処理において、認証情報とエンドユーザ PC 内の CPU 情報とを照合するかどうかを設定します。
・APIActivateStatusCheck メソッド（エンドユーザ PC 内での認証状態の確認）
・APIActivateStatusCheckOnline メソッド（オンラインで認証状態の確認）
・APIRestoreRegisterStatus メソッド（「認証登録状態回復」処理の実行）【構文】<VB.NET>
Public Property APIUseCpuInfo As Boolean<C#>public bool APIUseCpuInfo { set; get; }【解説】
認証レスキュー！の認証 UI ライブラリでは、認証登録など各処理時にエンドユーザ PC の CPU 情報を記録します。当プロパティを True にするとエンドユーザ PC の CPU 情報を認証識別情報として利用します。これを利用することでエンドユーザ PC の不正利用時の認証識別情報の精度を上げます。
※APIRestoreRegisterStatus メソッド（「認証登録状態回復」処理の実行）を使用する際は、当プロパ
ティを必ず True に設定してください。

「認証レスキュー！.NET」 ユーザーズガイド- 205 -

APIUseMacAddress プロパティ【機能】
MAC アドレスの使用（デフォルト：True）を設定します。
次の 3 つのメソッドの処理において、認証情報とエンドユーザ PC 内の MAC アドレスとを照合するかどうかを設定します。
・APIActivateStatusCheck メソッド（エンドユーザ PC 内での認証状態の確認）
・APIActivateStatusCheckOnline メソッド（オンラインで認証状態の確認）
・APIRestoreRegisterStatus メソッド（「認証登録状態回復」処理の実行）【構文】<VB.NET>
Public Property APIUseMacAddress As Boolean<C#>public bool APIUseMacAddress { set; get; }【解説】
認証レスキュー！の認証 UI ライブラリでは、認証登録など各処理時にエンドユーザ PC の MAC アド
レスを最大で 5 個記録します。MAC アドレスは LAN ポートなどのネットワーク機器に固有な物理アドレスです。MAC アドレスは、たとえば"E840F260C430"といった文字列です
当プロパティを True にするとエンドユーザ PC の MAC アドレスを認証識別情報として利用します。
これを利用することでエンドユーザ PC の不正利用時の認証識別情報の精度を上げます。
※APIRestoreRegisterStatus メソッド（「認証登録状態回復」処理の実行）を使用する際は、当プロパ
ティを必ず True に設定してください。

「認証レスキュー！.NET」 ユーザーズガイド- 206 -

APIUseProxyServer プロパティ【機能】
プロキシサーバーの使用区分（デフォルト：False）を設定します。
【構文】<VB.NET>
Public Property APIUseProxyServer As Boolean<C#>public bool APIUseProxyServer { set; get; }【解説】
プロキシサーバーの使用区分（デフォルト：False）を設定します。
インターネットに接続する際にプロキシサーバーを使用するかどうかを設定します。
プロキシサーバーを使用する場合は当プロパティに True を、使用しない場合は False をそれぞれ設定します。
プロキシサーバーを使用する場合は、次のプロパティに適切な設定が必要です。
・APIProxyServerAddress プロパティ（プロキシサーバーのアドレス）
・APIProxyServerPort プロパティ（プロキシサーバーのポート）
・APIProxyServerUserName プロパティ（プロキシサーバーのユーザ名）
・APIProxyServerPassword プロパティ（プロキシサーバーのパスワード）
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIActivateRegisterInternet メソッド（インターネットによる認証登録を実行）
・APIActivateRemoveInternet メソッド（インターネットによる認証解除を実行）
・APIProxyActivateRegisterExecute メソッド（代理認証登録/実行）・APIProxyActivateRemoveExecute メソッド（代理認証解除/実行）・APIRestoreRegisterStatus メソッド（認証登録状態回復）
・APIRestoreCancelStatus メソッド（認証解除状態回復）
・APIUpdateOfExpirationDate メソッド（有効期限の更新）「認証レスキュー！.NET」 ユーザーズガイド- 207 -

APIVendorsProductStartRegistryKeyPath プロパティ【機能】
ベンダアプリケーション開始レジストリキーパスを設定します。
【構文】<VB.NET>
Public Property APIVendorsProductStartRegistryKeyPath As String<C#>public string APIVendorsProductStartRegistryKeyPath { set; get; }【解説】
エンドユーザに配布したアプリケーションが認証 UI ライブラリ（DLL）の機能を使う場合、その各種情報の記録先として使うエンドユーザ PC 上のレジストリの開始キーのパスを当プロパティに指定します。レジストリ内の「HKEY_LOCAL_MACHINE」以降を指定します。
（例）"Software\Newtone\NinshoRescue\NRD\SampleProject"
なお、物理的なレジストリの位置は動作する貴社のアプリケーションが32bitなのか64bitなのかと、動作するPCのOSが32bitなのか64bitなのかによって異なります。
たとえば、HKEY_LOCAL_MACHINE\SOFTWARE\ABCというレジストリパスは次のようになります。
32bitOS上で32bitアプリケーションが動作する場合、または64bitOS上で64bitアプリケーションが動作する場合は、
HKEY_LOCAL_MACHINE\SOFTWARE\ABC
そのままです。
しかし、64bitOS上で32bitアプリケーションが動作する場合は、
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ABCとなります。
また、貴社の異なる複数のアプリケーションをエンドユーザの同一PC上で使用させるには、当プロパティにアプリケーションごとのそれぞれ異なるレジストリパスを設定してください。たとえば、次のよ
うに設定します。
アプリケーションA内での設定コード例：
APIVendorsProductStartRegistryKeyPath = "Software\Company\A"
アプリケーションB内での設定コード例：
APIVendorsProductStartRegistryKeyPath = "Software\Company\B"「認証レスキュー！.NET」 ユーザーズガイド- 208 -

APIWebServiceBasicAuthenticationPassword プロパティ【機能】
Web サービス時の基本認証パスワードを設定します。
【構文】<VB.NET>
Public Property APIWebServiceBasicAuthenticationPassword As String<C#>public string APIWebServiceBasicAuthenticationPassword { set; get; }【解説】
Web サーバーで基本認証を使用する場合に、そのパスワードを指定します。
基本認証に関しては、APIWebServiceUseBasicAuthentication プロパティを参照してください。

「認証レスキュー！.NET」 ユーザーズガイド- 209 -

APIWebServiceBasicAuthenticationUserName プロパティ【機能】
Web サービス時の基本認証ユーザ名を設定します。
【構文】<VB.NET>
Public Property APIWebServiceBasicAuthenticationUserName As String<C#>public string APIWebServiceBasicAuthenticationUserName { set; get; }【解説】
Web サーバーで基本認証を使用する場合に、そのユーザ名を指定します。
基本認証に関しては、APIWebServiceUseBasicAuthentication プロパティを参照してください。

「認証レスキュー！.NET」 ユーザーズガイド- 210 -

APIWebServiceCheckPassword プロパティ【機能】
Web サービス確認パスワード(8 文字以上)を設定します。
【構文】<VB.NET>
Public Property APIWebServiceCheckPassword As String<C#>public string APIWebServiceCheckPassword { set; get; }【解説】
Web サービスを利用する場合の確認用のパスワードを設定します。ここでは、Web サーバー側設定
アプリケーション「認証 Web サービス」の環境設定処理の Web サービスの確認パスワードと同じものを設定します。
確認パスワードは必須項目です、省略はできません。8 文字以上で半角の次の文字が使用できます。
・大文字の英字（A～Z）
・小文字の英字（a～ｚ）
・数字（0～9）・記号（+-*/!#$%&()=\@<>?）「認証レスキュー！.NET」 ユーザーズガイド- 211 -

APIWebServiceTimeout プロパティ【機能】
Web サービスのタイムアウト（デフォルト：60 秒）を設定します。
【構文】<VB.NET>
Public Property APIWebServiceTimeout As Integer<C#>public int APIWebServiceTimeout { set; get; }【解説】
Web サービスに接続して応答を待つ最大時間を秒単位で指定します。初期値は 60 秒です。

「認証レスキュー！.NET」 ユーザーズガイド- 212 -

APIWebServiceURL プロパティ【機能】
Web サービスの URL を設定します。
【構文】<VB.NET>
Public Property APIWebServiceURL As String<C#>public string APIWebServiceURL { set; get; }【解説】
認証に関するシステムを Web サービスとして提供する Web サーバーの URL を指定します。
以下に例を示します。
自 PC のローカルホストの Web サーバー（IIS）にアクセスする例："http://localhost/NRDWebService/Service.asmx"（注）この例は実際の運用ではありえません。貴社のアプリケーションで認証 UI ライブラリ（DLL）を使用した開発時に、テスト用に使用される URL です。
自社 Web サーバー（IIS）にアクセスさせる例："http://www.newtone.co.jp/NRDWebService/Service.asmx"
クラウドサービス Microsoft Azure の Web アプリ（App Service）に配置した Web サービスを利用する例："http://newtonecojp.azurewebsites.net/Service.asmx"「認証レスキュー！.NET」 ユーザーズガイド- 213 -

APIWebServiceUseBasicAuthentication プロパティ【機能】
Web サービス時の基本認証の使用（デフォルト：False）を設定します。
【構文】<VB.NET>
Public Property APIWebServiceUseBasicAuthentication As Boolean<C#>public bool APIWebServiceUseBasicAuthentication { set; get; }【解説】
Web サーバーで基本認証を使用する場合は、当プロパティを True にします。
初期値は、False（基本認証を使用しない）です。
当プロパティは、Web サーバー（IIS）側で特定のアカウント（ユーザ名とパスワード）でアクセスできる
フォルダにこの Web サービスが配置してある場合に使用できるセキュリティ設定です。
Web サーバーで基本認証を使用する一般的な手順は次の通りです。
1.サーバーPC 上でユーザを作成。
この際のユーザ名とパスワードがそのまま基本認証に使われます。
2.基本認証フォルダのセキュリティ設定
フォルダのプロパティを開き、セキュリティタブで上記 1 のユーザ名を 追加し、「読み取り」権限を付与します。
3.IIS でのセキュリティ設定
IIS で該当フォルダに対し「認証」の設定で「匿名認証」を無効にして 「基本認証」を有効にします。
なお、Web サーバーでの基本認証の詳細につきましてはマイクロソフト社の関連ドキュメントをご覧ください。

「認証レスキュー！.NET」 ユーザーズガイド- 214 -

<カスタム UI 系メソッド>
メソッド一覧
メソッド
APIActivateRegisterInternet
APIActivateRegisterTelephone
APIActivateRemoveInternet
APIActivateRemoveTelephone
APIActivateStatusCheck
APIActivateStatusCheck2

機能
インターネットによる認証登録の実行
電話による認証登録の実行
インターネットによる認証解除の実行
電話による認証解除の実行
エンドユーザ PC 内での認証状態の確認
エンドユーザ PC 内での認証状態の確認（Windows の管理者でなくても実行可能）
APIActivateStatusCheckOnline
オンラインで認証状態の確認
APIActivateStatusCheckOnline2
オンラインで認証状態の確認（Windows の管理者でなくても実行可能）APIActivateStatusOnlineVerify
オンラインで認証状態の確認
APIDeterminationOfProxyUpdateOfExp 「代理有効期限更新/確定」処理の実行
irationDate
APIFloatingLicenseCancel
フローティングライセンス登録解除の実行
APIFloatingLicenseFinish
フローティングライセンス使用終了の実行
APIFloatingLicenseRegister
フローティングライセンス登録の実行
APIFloatingLicenseStart
フローティングライセンス使用開始の実行
APIGenerationOfNewCertificationID
新規認証 ID の生成
APIGetFreeItem
プロダクト ID とシリアル No.を指定して、ActivationKey テーブルより自由入力項目を取得
APIGetProductIdSerialNoList
外部データベースとのリンク用キー項目を指定しActivationKey テーブルよりプロダクト ID とシリアル No.
のペア文字列の列挙を取得
APIGetProxyDataForExpirationDate
代理有効期限取得データの取得
APIGetProxyDataForRegister
代理認証登録データの取得
APIGetProxyDataForRemove
代理認証解除データの取得
APIGetProxyUpdateOfExpirationDate「代理有効期限/取得」処理の実行（代理 PC で利用）
APIGetRegisteredInfoFromRegistry（レジストリからの）認証登録済み情報の取得
APIGetRegisteredInfoFromRegistry2（レジストリからの）認証登録済み情報の取得（Windowsの管理者でなくても実行可能）
APIGetRegisteredInfoFromWeb
インターネットを使用して ActivationKeyTable から「ライセンス数」「有効期限の利用」「有効期限」を、
ActivationDataTable から「認証 ID」「認証日時（作成日）」
を取得します。
APIPreparationOfProxyUpdateOfExpir 「代理有効期限取得/準備」処理の実行
ationDate
APIProxyActivateRegisterExecute「代理認証登録/実行」処理の実行（代理 PC で利用）
APIProxyActivateRegisterFix「代理認証登録/確定」処理の実行
APIProxyActivateRegisterPrepare「代理認証登録/準備」処理の実行
APIProxyActivateRemoveExecute「代理認証解除/実行」処理の実行（代理 PC で利用）
APIProxyActivateRemovePrepare「代理認証解除/準備」処理の実行
APIReadProxyServerInfoFromRegistry レジストリからプロキシサーバーの情報を取得
APIRestoreCancelStatus「認証解除状態回復」処理の実行
APIRestoreRegisterStatus「認証登録状態回復」処理の実行「認証レスキュー！.NET」 ユーザーズガイド- 215 -APIRunNR2AppDateRemove
APIRunNR2AppDateRemove2
APITrialStartDateRemove
APIUpdateOfExpirationDate
APIWriteProxyServerInfoToRegistry「アプリ起動日」を削除「アプリ起動日」を削除「猶予日数」の「開始日」を削除
有効期限更新の実行
レジストリへプロキシサーバーの情報を書き込み「認証レスキュー！.NET」 ユーザーズガイド- 216 -

APIActivateRegisterInternet メソッド
【機能】
インターネットによる認証登録を実行します。
【構文】<VB.NET>
Public Function APIActivateRegisterInternet() As Boolean<C#>public bool APIActivateRegisterInternet()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPICertificationID

UI
UI
UI
UI
UI
UI

APIProductID
APISerialNo
APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName

UI

APIProxyServerPassword

Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress（認証登録する）認証 ID（取得専用）。
新規認証 ID 生成メソッド（APIGenerationOfNewCertificationID メソッド）の実行により、新しい認証 ID が当プ
ロパティに設定されます。
（認証登録する）プロダクト ID（認証登録する）シリアル No.
プロキシサーバーの使用区分
プロキシサーバーのアドレス プ ロ キ シ
サーバー
プロキシサーバーのポート
プロキシサーバーのユーザ 使用時
名
プロキシサーバーのパスワ
ード
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分「認証レスキュー！.NET」 ユーザーズガイド- 217 -

Code
Code
Code
Code
Code
Code
Code

APIVendorsProductStartRegistryKeyPath

ベンダアプリケーション開始レジストリキーパス
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
インターネットによる認証登録を実行します。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」は、新規認証 ID 生成メソッド（APIGenerationOfNewCertificationID メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）で取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1]新規認証 ID 生成メソッド（APIGenerationOfNewCertificationID メソッド）を実行します。
これにより、認証 ID プロパティ（APICertificationID プロパティ）に新しい認証 ID が設定されます。
その内容を画面に表示します。この内容表示そのものは必須ではありません。
[2]プロダクト ID とシリアル No.をエンドユーザに画面より入力させ、プロダクト ID プロパティ（APIProductID プロパティ）とシリアル No. プロパティ（APISerialNo プロパティ）にそれぞれ設定します。あるいは、別の方法で結果としてプロダクト ID プロパティ（APIProductID プロパティ）とシリ
アル No. プロパティ（APISerialNo プロパティ）にそれぞれ認証登録するプロダクト ID とシリアル No.
を設定します。
「認証レスキュー！.NET」 ユーザーズガイド- 218 -

[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[4] 上 記 の 「 想 定 UI 画 面 」 の 「 登 録 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIActivateRegisterInternet メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 219 -

APIActivateRegisterTelephone メソッド
【機能】
電話による認証登録を実行します。
【構文】<VB.NET>
Public Function APIActivateRegisterTelephone() As Boolean<C#>public bool APIActivateRegisterTelephone()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPICertificationID

UI
UI
UI

APIProductID
APISerialNo
APILicenseKey

Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

Code

APIWebServiceBasicAuthenticationPassword（認証登録する）認証 ID（取得専用）。
新規認証 ID 生成メソッド（APIGenerationOfNewCertificationID メソッド）の実行により、新しい認証 ID が当プ
ロパティに設定されます。
（認証登録する）プロダクト ID（認証登録する）シリアル No.
ライセンスキー（貴社電話担当者より告げられたライセン
スキーを設定）処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキーパス
Web サービス時の基本認証パスワード（基本認証使用時）「認証レスキュー！.NET」 ユーザーズガイド- 220 -

Code
Code
Code
Code
Code

APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
電話による認証登録を実行します。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」は、新規認証 ID 生成メソッド（APIGenerationOfNewCertificationID メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）で取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1]新規認証 ID 生成メソッド（APIGenerationOfNewCertificationID メソッド）を実行します。
これにより、認証 ID プロパティ（APICertificationID プロパティ）に新しい認証 ID が設定されます。
その内容を画面に表示します。
[2]プロダクト ID とシリアル No.をエンドユーザに画面より入力させ、プロダクト ID プロパティ（APIProductID プロパティ）とシリアル No. プロパティ（APISerialNo プロパティ）にそれぞれ設定します。あるいは、別の方法で結果としてプロダクト ID プロパティ（APIProductID プロパティ）とシリ
アル No. プロパティ（APISerialNo プロパティ）にそれぞれ認証登録するプロダクト ID とシリアル No.
を設定します。
[3]エンドユーザに貴社に電話をしてもらいます。貴社のオペレータより聞いたライセンスキーを画面「認証レスキュー！.NET」 ユーザーズガイド- 221 -

より入力させ、その値をライセンスキープロパティ（APILicenseKey プロパティ）に設定します。
[4]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[5] 上 記 の 「 想 定 UI 画 面 」 の 「 登 録 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIActivateRegisterTelephone メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 222 -

APIActivateRemoveInternet メソッド
【機能】
インターネットによる認証解除を実行します。
【構文】<VB.NET>
Public Function APIActivateRemoveInternet() As Boolean<C#>public bool APIActivateRemoveInternet()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

UI

APICertificationID

UI

APIProductID

UI

APISerialNo

UI
UI

APIUseProxyServer
APIProxyServerAddress

UI

APIProxyServerPort（登録解除する）認証 ID（取得専用）。
（レジストリからの）認証登録済み情報の
取
得
メ
ソ
ッ
ド
（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みの認証 ID が
当プロパティに設定されます。
（認証解除する）プロダクト ID（レジストリからの）認証登録済み情報の
取
得
メ
ソ
ッ
ド
（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みのプロダクト
ID が当プロパティに設定されます。
（認証解除する）シリアル No.
（レジストリからの）認証登録済み情報の
取
得
メ
ソ
ッ
ド
（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みのシリアル No.
が当プロパティに設定されます。
プロキシサーバーの使用区分
プロキシサーバーのアド プロキシサー
レス
バー使用時
プロキシサーバーのポー 有効ト「認証レスキュー！.NET」 ユーザーズガイド- 223 -UI

APIProxyServerUserName

UI

APIProxyServerPassword

Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

Code
Code

APIWebServiceBasicAuthenticationPassword
APIWebServiceBasicAuthenticationUserNam
e
APIWebServiceCheckPassword
APIWebServiceTimeout
APIWebServiceURL
APIWebServiceUseBasicAuthentication

Code
Code
Code
Code

プロキシサーバーのユー
ザ名
プロキシサーバーのパス
ワード
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキー
パス
Web サービス時の基本認証パスワード
Web サービス時の基本認証ユーザ名
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
インターネットによる認証解除を実行します。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」、「プロダクト ID」、「シリアル No.」は、（レジストリからの）認証登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）、プロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.
プロパティ（APISerialNo プロパティ）でそれぞれ取得できます。

「認証レスキュー！.NET」 ユーザーズガイド- 224 -

◆処理手順
一連の処理の手順は次の通りです。
[1]（レジストリからの）認証登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）
を実行します。これにより、認証 ID プロパティ、プロダクト ID プロパティ、シリアル No.プロパティに各値が設定されます。
[2]認証 ID プロパティ、プロダクト ID プロパティ、シリアル No.プロパティの各値を画面に表示します。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[4] 上 記 の 「 想 定 UI 画 面 」 の 「 解 除 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIActivateRemoveInternet メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 225 -

APIActivateRemoveTelephone メソッド
【機能】
電話による認証解除を実行します。
【構文】<VB.NET>
Public Function APIActivateRemoveTelephone() As Boolean<C#>public bool APIActivateRemoveTelephone()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、正常終了時には、解除ステータスプロパティ（APIReleaseStatus プロパティ）に解除ステータスが設定されます。
また、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

UI

APICertificationID

UI

APIProductID

UI

APISerialNo

UI
UI
Code

APIReleaseKey
APIReleaseStatus
APIDisabledNICIgnore（登録解除する）認証 ID（取得専用）。
（レジストリからの）認証登録済み情報の
取
得
メ
ソ
ッ
ド
（ APIGetRegisteredInfoFromRegistry メ ソッド）の実行により、登録済みの認証 ID が
当プロパティに設定されます。
（認証解除する）プロダクト ID（レジストリからの）認証登録済み情報の
取
得
メ
ソ
ッ
ド
（ APIGetRegisteredInfoFromRegistry メ ソッド）の実行により、登録済みのプロダクト
ID が当プロパティに設定されます。
（認証解除する）シリアル No.
（レジストリからの）認証登録済み情報の
取
得
メ
ソ
ッ
ド
（ APIGetRegisteredInfoFromRegistry メ ソッド）の実行により、登録済みのシリアルNo.が当プロパティに設定されます。
解除キー
解除ステータス（取得専用）
処理を高速化するため、無効になってい「認証レスキュー！.NET」 ユーザーズガイド- 226 -

Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code

る NIC（Network Interface Card）を無視します。
APIEncryptionPassword
暗号化時のパスワード
APIEncryptionSaltString
暗号化時の Salt 文字列
APITrialPeriod
猶予（試用）日数APIUseCpuInfo
CPU 情報の使用区分
APIUseMacAddress
MAC アドレスの使用区分
APIVendorsProductStartRegistryKeyPath
ベンダアプリケーション開始レジストリキーパス
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名
APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
電話による認証解除を実行します。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」、「プロダクト ID」、「シリアル No.」は、（レジストリからの）認証登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）、プロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.
プロパティ（APISerialNo プロパティ）でそれぞれ取得できます。
この画面上の「解除キー」は、貴社オペレータより電話経由でエンドユーザが聞いて画面より入力し「認証レスキュー！.NET」 ユーザーズガイド- 227 -

た解除キーの値を解除キープロパティに設定します。
この画面上の「解除ステータス」は、当メソッド（APIActivateRemoveTelephone メソッド）の実行後の正常終了時に解除ステータスプロパティ（APIReleaseStatus プロパティ）で取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1]（レジストリからの）認証登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）
を実行します。これにより、認証 ID プロパティ、プロダクト ID プロパティ、シリアル No.プロパティに各値が設定されます。
[2]認証 ID プロパティ、プロダクト ID プロパティ、シリアル No.プロパティの各値を画面に表示します。
[3]解除キープロパティ（APIReleaseKey プロパティ）に、貴社オペレータより電話経由でエンドユーザ
が聞いて画面より入力した解除キーの値を設定します。
[4]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[5] 上 記 の 「 想 定 UI 画 面 」 の 「 解 除 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIActivateRemoveTelephone メソッド）を実行します。
[6]当メソッド（APIActivateRemoveTelephone メソッド）の実行後、正常終了時には、解除ステータス
プロパティ（APIReleaseStatus プロパティ）に解除ステータス（文字列）が設定されますので、エンドユーザにその解除ステータスを電話で貴社のオペレータに伝えてもらいます。

「認証レスキュー！.NET」 ユーザーズガイド- 228 -

APIActivateStatusCheck メソッド【機能】
エンドユーザ PC 内での認証状態の確認を行います。
【構文】<VB.NET>
Public Function APIActivateStatusCheck() As Integer<C#>public int APIActivateStatusCheck()

【引数】
なし
【戻り値】
0：
1～365：
366：
400：
500：
600：
1000：
1001～2100：
2101：
-999：
-1：
-21001231～-20000101：-21001232：-3：
20000101～21001231：
200001010～210012310：-210012310～-200001010：

猶予期限切れ（猶予有効時）
猶予日数有
日付データの取得失敗（猶予）
未認証（猶予無効時）
認証済み
フローティングライセンス登録済
欠番（旧レンタル機能関連）
欠番（旧レンタル機能関連）
欠番（旧レンタル機能関連）
認証済ハードウェア情報不一致
エラー（未設定や範囲を超えているプロパティがある）
認証済で終了した有効期限（2000/01/01～2100/12/31）
日付データの取得失敗（有効期限）
PC の日付が変更されました。
認証済でまだ有効な有効期限（2000/01/01～2100/12/31）
フローティングライセンスが登録済でまだ有効な有効期限（2000/01/01～2100/12/31）
フローティングライセンスが登録済で終了した有効期限（2000/01/01～2100/12/31）

戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※Code

APIDisabledNICIgnore

Code
Code

APIEncryptionPassword
APIEncryptionSaltString

処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列「認証レスキュー！.NET」 ユーザーズガイド- 229 -

Code
Code
Code
Code
Code

APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIWebServiceCheckPassword
APIVendorsProductStartRegistryKeyPath

猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
Web サービス確認パスワード
ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ<戻り値が 200001010～210012310 または-210012310～-200001010 の場合>
戻り値を 10 で割って値が有効期限となります。
例：
戻り値が 202412200 の場合
202412200 ÷ 10 = 20241220
1～4 桁目が年→2024
5～6 桁目が月→12
7～8 桁目が日→20
よって、2024 年 12 月 20 日となります。
【解説】
こ の APIActivateStatusCheck メ ソ ッ ド と APIActivateStatusCheckOnline メ ソ ッ ド の 相 違 点 は
APIActivateStatusCheck メ ソ ッ ド が エ ン ド ユ ー ザ PC 内 で の 認 証 状 況 を 返 す の に 対 し 、APIActivateStatusCheckOnline メソッドはインターネットを介し貴社のデータベースにアクセスして取得した情報とエンドユーザ PC 内の情報とを照合して認証状況を返す点です。

「認証レスキュー！.NET」 ユーザーズガイド- 230 -

APIActivateStatusCheck2 メソッド【機能】
エンドユーザ PC 内での認証状態の確認を行います。
Windows の管理者でなくても実行可能です。
【構文】<VB.NET>
Public Function APIActivateStatusCheck2() As Integer<C#>public int APIActivateStatusCheck2()

【引数】
なし
【戻り値】
0：
1～365：
366：
400：
500：
600：
1000：
1001～2100：
2101：
-999：
-1：
-21001231～-20000101：-21001232：-3：
20000101～21001231：
200001010～210012310：-210012310～-200001010：

猶予期限切れ（猶予有効時）
猶予日数有
日付データの取得失敗（猶予）
未認証（猶予無効時）
認証済み
フローティングライセンス登録済
欠番（旧レンタル機能関連）
欠番（旧レンタル機能関連）
欠番（旧レンタル機能関連）
認証済ハードウェア情報不一致
エラー（未設定や範囲を超えているプロパティがある）
認証済で終了した有効期限（2000/01/01～2100/12/31）
日付データの取得失敗（有効期限）
PC の日付が変更されました。
認証済でまだ有効な有効期限（2000/01/01～2100/12/31）
フローティングライセンスが登録済でまだ有効な有効期限（2000/01/01～2100/12/31）
フローティングライセンスが登録済で終了した有効期限（2000/01/01～2100/12/31）

戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※Code

APIDisabledNICIgnore

Code

APIEncryptionPassword

処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード「認証レスキュー！.NET」 ユーザーズガイド- 231 -

Code
Code

APIEncryptionSaltString
APISelectRunAppDatePathFlag

Code
Code
Code
Code
Code

APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIWebServiceCheckPassword
APIVendorsProductStartRegistryKeyPath

暗号化時の Salt 文字列「アプリ起動日」の読み込み/書き込み場
所の切り替えフラグ
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
Web サービス確認パスワード
ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ<戻り値が 200001010～210012310 または-210012310～-200001010 の場合>
戻り値を 10 で割って値が有効期限となります。
例：
戻り値が 202412200 の場合
202412200 ÷ 10 = 20241220
1～4 桁目が年→2024
5～6 桁目が月→12
7～8 桁目が日→20
よって、2024 年 12 月 20 日となります。
【解説】
以下の機能以外は従来の APIActivateStatusCheck メソッドと同等です。
APISelectRunAppDatePathFlag プロパティ値による場所+従来のAPIVendorsProductStartRegistryKeyPath プロパティ値の場所に「アプリ起動日」の読み込み/書き込みを行います。
このメソッドは、ユーザ様からのご要望で追加されました。
認証レスキュー！は、認証情報などをレジストリの
HKEY_LOCAL_MACHINE + APIVendorsProductStartRegistryKeyPath プロパティ値の場所へ書き込
み/読み込みを行っています。
APITrialPeriod プロパティ（猶予（試用）日数）が 0 以上に設定されていて、このメソッドが初めて実行された場合、残日数を確認するための開始日をレジストリに書き込みます。
その後、残日数が切れるまではレジストリへの書き込み処理はありませんでした。
しかし、バージョン 2.6.2 以降は、故意に PC の日付が変更されることを防ぐために、このメソッドを起動する度にレジストリに情報を書き込むよう変更されました。
前出のユーザ様は、Windows の管理者でなくても認証状況を確認したいとのご要望で、この故意にPC の日付が変更されることを防ぐための書き込み部分のみ「HKEY_CURRENT_USER（レジストリ）」あるいは「ProgramData（フォルダ）」へ書き込みを変更するため、このメソッドが追加されました。

「認証レスキュー！.NET」 ユーザーズガイド- 232 -

APIActivateStatusCheckOnline メソッド
【機能】
オンラインで認証状態の確認を行います。
【構文】<VB.NET>
Public Function APIActivateStatusCheckOnline() As Integer<C#>public int APIActivateStatusCheckOnline()

【引数】
なし
【戻り値】
0：
PC レベルで認証されていない（PC のレジストリには認証登録情報がない）
1：
OK（PC レベルと DB で認証登録情報が一致した）
2：
NG（PC レベルと一致する認証登録情報が DB にない）
3：
NG（認証済ハードウェア情報不一致）
4：
NG（日付データの取得失敗（猶予））5：
欠番（旧レンタル機能関連）
6：
NG（日付データの取得失敗（有効期限））-11：
接続できない（認証時は電話）-12：接続できない（認証時は代理）-13：接続できない（フローティングライセンス）-999： その他エラー（接続できないなど）-1：
エラー（未設定や範囲を超えているプロパティがある）-3：
PC の日付が変更されました。
600：
フローティングライセンス登録済
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

UI
UI
UI
UI

APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName

UI

APIProxyServerPassword

Code

APIDisabledNICIgnore

プロキシサーバーの使用区分
プロキシサーバーのアドレス プ ロ キ シ
サーバー
プロキシサーバーのポート
プロキシサーバーのユーザ 使用時
名
プロキシサーバーのパスワ
ード
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。

「認証レスキュー！.NET」 ユーザーズガイド- 233 -

Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキーパス
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
この APIActivateStatusCheckOnline メソッドと APIActivateStatusCheck メソッドとの相違点はAPIActivateStatusCheck メ ソ ッ ド が エ ン ド ユ ー ザ PC 内 で の 認 証 状 況 を 返 す の に 対 し 、APIActivateStatusCheckOnline メソッドはインターネットを介し貴社のデータベースにアクセスして取得した情報とエンドユーザ PC 内の情報とを照合して認証状況を返す点です。
この APIActivateStatusCheckOnline メソッドは、なんらかの理由で現在エンドユーザが使用している
貴社のアプリケーションを使用不可としたい場合などに利用できます。
認証登録の場合、レジストリとハード情報だけの確認で OK となってしまい貴社がデータベース（DB）
上の当該情報を削除してもエンドユーザの PC ではアプリケーションが継続して使用できてしまいます。そこで、任意のタイミングでインターネットを介し貴社のデータベースにアクセスしてそれらの情報を確認できる機能がこのメソッドです。貴社はたとえば、アプリケーションの起動時にそのメソッドを利用するコードを記述し、その戻り値によってアプリケーションを（強制的に）終了する、といった挙動を制御できます。

「認証レスキュー！.NET」 ユーザーズガイド- 234 -

APIActivateStatusCheckOnline2 メソッド
【機能】
オンラインで認証状態の確認を行います。
Windows の管理者でなくても実行可能です。
【構文】<VB.NET>
Public Function APIActivateStatusCheckOnline2() As Integer<C#>public int APIActivateStatusCheckOnline2()

【引数】
なし
【戻り値】
0：
PC レベルで認証されていない（PC のレジストリには認証登録情報がない）
1：
OK（PC レベルと DB で認証登録情報が一致した）
2：
NG（PC レベルと一致する認証登録情報が DB にない）
3：
NG（認証済ハードウェア情報不一致）
4：
NG（日付データの取得失敗（猶予））5：
欠番（旧レンタル機能関連）
6：
NG（日付データの取得失敗（有効期限））-11：
接続できない（認証時は電話）-12：接続できない（認証時は代理）-13：接続できない（フローティングライセンス）-999： その他エラー（接続できないなど）-1：
エラー（未設定や範囲を超えているプロパティがある）-3：
PC の日付が変更されました。
600：
フローティングライセンス登録済
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

UI
UI
UI
UI

APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName

UI

APIProxyServerPassword

Code

APIDisabledNICIgnore

プロキシサーバーの使用区分
プロキシサーバーのアドレス プ ロ キ シ
サーバー
プロキシサーバーのポート
プロキシサーバーのユーザ 使用時
名
プロキシサーバーのパスワ
ード
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
「認証レスキュー！.NET」 ユーザーズガイド- 235 -

Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキーパス
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
以下の機能以外は従来の APIActivateStatusCheckOnline メソッドと同等です。
APISelectRunAppDatePathFlag プロパティ値による場所+従来のAPIVendorsProductStartRegistryKeyPath プロパティ値の場所に「アプリ起動日」の読み込み/書き込みを行います。
このメソッドは、ユーザ様からのご要望で追加されました。
認証レスキュー！は、認証情報などをレジストリの
HKEY_LOCAL_MACHINE + APIVendorsProductStartRegistryKeyPath プロパティ値の場所へ書き込
み/読み込みを行っています。
APITrialPeriod プロパティ（猶予（試用）日数）が 0 以上に設定されていて、このメソッドが初めて実行された場合、残日数を確認するための開始日をレジストリに書き込みます。
その後、残日数が切れるまではレジストリへの書き込み処理はありませんでした。
しかし、バージョン 2.6.2 以降は、故意に PC の日付が変更されることを防ぐために、このメソッドを起動する度にレジストリに情報を書き込むよう変更されました。
前出のユーザ様は、Windows の管理者でなくても認証状況を確認したいとのご要望で、この故意にPC の日付が変更されることを防ぐための書き込み部分のみ「HKEY_CURRENT_USER（レジストリ）」あるいは「ProgramData（フォルダ）」へ書き込みを変更するため、このメソッドが追加されました。

「認証レスキュー！.NET」 ユーザーズガイド- 236 -

APIActivateStatusOnlineVerify メソッド
【機能】
オンラインで認証状態の確認を行います。
【構文】<VB.NET>
Public Function APIActivateStatusOnlineVerify() As Integer<C#>public int APIActivateStatusOnlineVerify()

【引数】
なし
【戻り値】
0：
1～365：
366：
400：
500：
600：
-999：
-1：
-21001231～-20000101：-21001232：-3：
20000101～21001231：
200001010～210012310：-210012310～-200001010：
-4：
-5：
-6：
-7：
-8：
-9：
7777：
8888：

猶予期限切れ（猶予有効時）
猶予日数有
日付データの取得失敗（猶予）
未認証（猶予無効時）
認証済み
フローティングライセンス登録済
認証済ハードウェア情報不一致
エラー（未設定や範囲を超えているプロパティがある）
認証済で終了した有効期限（2000/01/01～2100/12/31）
日付データの取得失敗（有効期限）
PC の日付が変更されました。
認証済でまだ有効な有効期限（2000/01/01～2100/12/31）
フローティングライセンスが登録済でまだ有効な有効期限（2000/01/01～2100/12/31）
フローティングライセンスが登録済で終了した有効期限（2000/01/01～2100/12/31）
該当する認証キーが存在しない
認証データが存在しない
Web サービスのメソッド内でエラーが発生
確認パスワードが不正使用できない文字列が含まれています。
WebServEnvNRD.wai ファイルに問題があります
Web サービスのメソッドの呼び出しでエラーが発生
Web サービスのメソッドの呼出し後に戻り値が見付からない

戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

「認証レスキュー！.NET」 ユーザーズガイド- 237 -

UI
UI
UI
UI
UI
Code

Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code

APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName

プロキシサーバーの使用区分
プロキシサーバーのアドレス プ ロ キ シ
サーバー
プロキシサーバーのポート
プロキシサーバーのユーザ 使用時
名
APIProxyServerPassword
プロキシサーバーのパスワ
ード
APIDisabledNICIgnore
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
APIEncryptionPassword
暗号化時のパスワード
APIEncryptionSaltString
暗号化時の Salt 文字列
APITrialPeriod
猶予（試用）日数（0：猶予期間なし）
APIUseCpuInfo
CPU 情報の使用区分
APIUseMacAddress
MAC アドレスの使用区分
APIVendorsProductStartRegistryKeyPath
ベンダアプリケーション開始レジストリキーパス
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ<戻り値が 200001010～210012310 または-210012310～-200001010 の場合>
戻り値を 10 で割って値が有効期限となります。
例：
戻り値が 202412200 の場合
202412200 ÷ 10 = 20241220
1～4 桁目が年→2024
5～6 桁目が月→12
7～8 桁目が日→20
よって、2024 年 12 月 20 日となります。
【解説】
この APIActivateStatusOnlineVerify メソッドと APIActivateStatusCheckOnline メソッドとの相違点はフローティングライセンス上限数、使用数、状況の情報、使用中の PC 一覧データがプロパティに設定されます。
これにより、エンドユーザ PC の現在のフローティングライセンス状況を把握でき、不要なフローティ
ングライセンス使用を防ぐことができます。
戻り値が「600」、「-210012310 ～ -200001010」、「200001010 ～ 210012310」の場合、次のプロパティにフローティングライセンスの各情報が設定されます。
・フローティングライセンス状況（APIFloatingLicenseState プロパティ）（0：未登録 1：登録済 2：使用中）
・フローティングライセンス上限数（APIFloatingLicenseMaxCount プロパティ）
・フローティングライセンス使用数（APIFloatingLicenseUsedCount プロパティ）「認証レスキュー！.NET」 ユーザーズガイド- 238 -

・フローティングライセンス使用中の PC 一覧データ（APIFloatingLicenseDataInfo プロパティ）
これらのプロパティは、正常に読み込みが成功しない限り、初期値（0）が設定されます。

「認証レスキュー！.NET」 ユーザーズガイド- 239 -

APIDeterminationOfProxyUpdateOfExpirationDate メソッド
【機能】
「代理有効期限更新/確定」を実行します。（有効期限を更新したい PC で利用）
【構文】
<VB.NET>
Public Function APIDeterminationOfProxyUpdateOfExpirationDate () As Boolean<C#>public bool APIDeterminationOfProxyUpdateOfExpirationDate()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPIProxyDataPath

UI

APIProductID

UI

APISerialNo

UI

APICurrentExpirationDate

UI

APINewExpirationDate（有効期限を更新する）代理有効期限取得データのパス
ファイルの拡張子は「.NRS」です。
（有効期限を更新する）プロダクト ID
代理有効期限取得データの読み込みメソッド（APIGetProxyDataForExpirationDate メソッド）の実行により、代理有効期限取得データから取得したプロダクト ID が当プロパティに設定されます。
（有効期限を更新する）シリアル No.
代理有効期限取得データの読み込みメソッド（APIGetProxyDataForExpirationDate メソッド）の実行により、代理有効期限取得データから取得したシリアル No.が当プロパティに設定されます。
（有効期限を更新する）現在の有効期限
代理有効期限取得データの読み込みメソッド（APIGetProxyDataForExpirationDate メソッド）の実行により、代理有効期限取得データから取得した現在の有効期限が当プロパティに設定されます。
（有効期限を更新する）新しい有効期限.
代理有効期限取得データの読み込みメソッド「認証レスキュー！.NET」 ユーザーズガイド- 240 -

Code
Code
Code
Code
Code
Code
Code
Code

（APIGetProxyDataForExpirationDate メソッド）の実行により、代理有効期限取得データから取得した新しい有効期限が当プロパティに設定されます。
APIDisabledNICIgnore
処理を高速化するため、無効になっている
NIC（Network Interface Card）を無視します。
APIEncryptionPassword
暗号化時のパスワード
APIEncryptionSaltString
暗号化時の Salt 文字列
APITrialPeriod
猶予（試用）日数（0：猶予期間なし）
APIUseCpuInfo
CPU 情報の使用区分
APIUseMacAddress
MAC アドレスの使用区分
APIWebServiceCheckPassword
Web サービス確認パスワード
APIVendorsProductStartRegistryKeyPath ベンダアプリケーション開始レジストリキーパ
ス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「代理有効期限更新/確定」を実行します。（有効期限を更新したい PC で利用）
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「プロダクト ID」、「シリアル No.」、「現在の有効期限」、「新しい有効期限」は、代理有効期限取得データの取得メソッド（APIGetProxyDataForExpirationDate メソッド）の実行で設定されるプロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.プロパティ（APISerialNo プロパティ）、
現在の有効期限プロパティ（APICurrentExpirationDate プロパティ）、新しい有効期限プロパティ（APINewExpirationDate プロパティ）でそれぞれ取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1] 代理有効期限取得データパスをエンドユーザに画面より入力させ、代理有効期限取得データパ
スプロパティ（APIProxyDataPath プロパティ）に設定します。この際、ファイルの拡張子は「.NRS」とし「認証レスキュー！.NET」 ユーザーズガイド- 241 -

ます。
[2] 代理有効期限取得データの取得メソッド（APIGetProxyDataForExpirationDate メソッド）を実行します。
これに より、 プロダクト ID プロパテ ィ（ APIProductID プロパテ ィ）、シリ アル No. プロパテ ィ（APISerialNo プロパティ）、現在の有効期限プロパティ（APICurrentExpirationDate プロパティ）、新しい有効期限プロパティ（APINewExpirationDate プロパティ）に代理有効期限取得データから取得したプロダクト ID、シリアル No.、現在の有効期限、新しい有効期限それぞれが設定されます。
それらの内容を画面に表示します。この内容表示そのものは必須ではありません。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[5] 上 記 の 「 想 定 UI 画 面 」 の 「 更 新 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIDeterminationOfProxyUpdateOfExpirationDate メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 242 -

APIFloatingLicenseCancel メソッド
【機能】
フローティングライセンス登録解除を実行します。
【構文】<VB.NET>
Public Function APIFloatingLicenseCancel() As Boolean<C#>public bool APIFloatingLicenseCancel()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

UI

APICertificationID

UI

APIProductID

UI

APISerialNo

UI
UI

APIUseProxyServer
APIProxyServerAddress

UI

APIProxyServerPort（解除する）認証 ID（取得専用）。
（レジストリからの）フローティングライセン
ス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みの認証 ID が
当プロパティに設定されます。
（解除する）プロダクト ID（レジストリからの）フローティングライセン
ス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みのプロダクト
ID が当プロパティに設定されます。
（解除する）シリアル No.
（レジストリからの）フローティングライセン
ス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みのシリアル No.
が当プロパティに設定されます。
プロキシサーバーの使用区分
プロキシサーバーのアド プロキシサー
レス
バー使用時
プロキシサーバーのポー 有効ト「認証レスキュー！.NET」 ユーザーズガイド- 243 -UI

APIProxyServerUserName

UI

APIProxyServerPassword

Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

Code
Code

APIWebServiceBasicAuthenticationPassword
APIWebServiceBasicAuthenticationUserNam
e
APIWebServiceCheckPassword
APIWebServiceTimeout
APIWebServiceURL
APIWebServiceUseBasicAuthentication

Code
Code
Code
Code

プロキシサーバーのユー
ザ名
プロキシサーバーのパス
ワード
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキー
パス
Web サービス時の基本認証パスワード
Web サービス時の基本認証ユーザ名
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
フローティングライセンス登録解除を実行します。
このメソッドは、APITrialPeriod プロパティが 0 以上に設定されている場合、実行できません。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

「認証レスキュー！.NET」 ユーザーズガイド- 244 -

この画面上の「認証 ID」、「プロダクト ID」、「シリアル No.」は、（レジストリからの）フローティングライ
センス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）、プロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.プロパティ（APISerialNo プロパティ）でそれぞれ取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1] （ レ ジ ス ト リ か ら の ） フ ロ ー テ ィ ン グ ラ イ セ ン ス 登 録 済 み 情 報 の 取 得 メ ソ ッ ド（APIGetRegisteredInfoFromRegistry メソッド）を実行します。これにより、認証 ID プロパティ、プロ
ダクト ID プロパティ、シリアル No.プロパティに各値が設定されます。
[2]認証 ID プロパティ、プロダクト ID プロパティ、シリアル No.プロパティの各値を画面に表示します。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[4] 上 記 の 「 想 定 UI 画 面 」 の 「 解 除 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIFloatingLicenseCancel メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 245 -

APIFloatingLicenseFinish メソッド
【機能】
フローティングライセンス使用終了を実行します。
【構文】<VB.NET>
Public Function APIFloatingLicenseFinish() As Boolean<C#>public bool APIFloatingLicenseFinish()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

UI

APICertificationID

UI

APIProductID

UI

APISerialNo

UI
UI

APIUseProxyServer
APIProxyServerAddress

UI

APIProxyServerPort（解除する）認証 ID（取得専用）。
（レジストリからの）フローティングライセン
ス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みの認証 ID が
当プロパティに設定されます。
（解除する）プロダクト ID（レジストリからの）フローティングライセン
ス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みのプロダクト
ID が当プロパティに設定されます。
（解除する）シリアル No.
（レジストリからの）フローティングライセン
ス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みのシリアル No.
が当プロパティに設定されます。
プロキシサーバーの使用区分
プロキシサーバーのアド プロキシサー
レス
バー使用時
プロキシサーバーのポー 有効ト「認証レスキュー！.NET」 ユーザーズガイド- 246 -UI

APIProxyServerUserName

UI

APIProxyServerPassword

Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

Code
Code

APIWebServiceBasicAuthenticationPassword
APIWebServiceBasicAuthenticationUserNam
e
APIWebServiceCheckPassword
APIWebServiceTimeout
APIWebServiceURL
APIWebServiceUseBasicAuthentication

Code
Code
Code
Code

プロキシサーバーのユー
ザ名
プロキシサーバーのパス
ワード
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキー
パス
Web サービス時の基本認証パスワード
Web サービス時の基本認証ユーザ名
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
フローティングライセンス使用終了を実行します。
このメソッドは、APITrialPeriod プロパティが 0 以上に設定されている場合、実行できません。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

「認証レスキュー！.NET」 ユーザーズガイド- 247 -

この画面上の「認証 ID」、「プロダクト ID」、「シリアル No.」は、（レジストリからの）フローティングライ
センス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）、プロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.プロパティ（APISerialNo プロパティ）でそれぞれ取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1] （ レ ジ ス ト リ か ら の ） フ ロ ー テ ィ ン グ ラ イ セ ン ス 登 録 済 み 情 報 の 取 得 メ ソ ッ ド（APIGetRegisteredInfoFromRegistry メソッド）を実行します。これにより、認証 ID プロパティ、プロ
ダクト ID プロパティ、シリアル No.プロパティに各値が設定されます。
[2]認証 ID プロパティ、プロダクト ID プロパティ、シリアル No.プロパティの各値を画面に表示します。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[4] 上 記 の 「 想 定 UI 画 面 」 の 「 使 用 終 了 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIFloatingLicenseFinish メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 248 -

APIFloatingLicenseRegister メソッド
【機能】
フローティングライセンス登録を実行します。
【構文】<VB.NET>
Public Function APIFloatingLicenseRegister() As Boolean<C#>public bool APIFloatingLicenseRegister()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPICertificationID

UI

APIProductID

UI

APISerialNo

UI
UI
UI
UI

APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName

UI

APIProxyServerPassword

Code

APIDisabledNICIgnore

Code
Code

APIEncryptionPassword
APIEncryptionSaltString（フローティングライセンス登録する）認証
ID（取得専用）。
新規認証 ID 生成メソッド（APIGenerationOfNewCertificationID メソッド）の実行により、新しい認証 ID が当プ
ロパティに設定されます。
（フローティングライセンス登録する）プロ
ダクト ID（フローティングライセンス登録する）シリ
アル No.
プロキシサーバーの使用区分
プロキシサーバーのアドレス プ ロ キ シ
サーバー
プロキシサーバーのポート
プロキシサーバーのユーザ 使用時
名
プロキシサーバーのパスワ
ード
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列「認証レスキュー！.NET」 ユーザーズガイド- 249 -

Code
Code
Code
Code
Code
Code
Code
Code
Code
Code

APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキーパス
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
フローティングライセンス登録を実行します。
このメソッドは、APITrialPeriod プロパティが 0 以上に設定されている場合、実行できません。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」は、新規認証 ID 生成メソッド（APIGenerationOfNewCertificationID メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）で取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1]新規認証 ID 生成メソッド（APIGenerationOfNewCertificationID メソッド）を実行します。
これにより、認証 ID プロパティ（APICertificationID プロパティ）に新しい認証 ID が設定されます。
その内容を画面に表示します。この内容表示そのものは必須ではありません。

「認証レスキュー！.NET」 ユーザーズガイド- 250 -

[2]プロダクト ID とシリアル No.をエンドユーザに画面より入力させ、プロダクト ID プロパティ（APIProductID プロパティ）とシリアル No. プロパティ（APISerialNo プロパティ）にそれぞれ設定します。あるいは、別の方法で結果としてプロダクト ID プロパティ（APIProductID プロパティ）とシリ
アル No. プロパティ（APISerialNo プロパティ）にそれぞれ認証登録するプロダクト ID とシリアル No.
を設定します。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[4] 上 記 の 「 想 定 UI 画 面 」 の 「 使 用 開 始 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIFloatingLicenseRegister メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 251 -

APIFloatingLicenseStart メソッド
【機能】
フローティングライセンス使用開始を実行します。
【構文】<VB.NET>
Public Function APIFloatingLicenseStart() As Boolean<C#>public bool APIFloatingLicenseStart()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPICertificationID

UI

APIProductID

UI

APISerialNo

UI
UI
UI
UI

APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName（開始する）認証 ID（取得専用）。
（レジストリからの）フローティングライセン
ス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みの認証 ID が
当プロパティに設定されます。
（開始する）プロダクト ID（レジストリからの）フローティングライセン
ス登録済み情報の取得メソッド（ APIGetRegisteredInfoFromRegistry メ ソッド）の実行により、登録済みのプロダクト
ID が当プロパティに設定されます。
（開始する）シリアル No.
（レジストリからの）フローティングライセン
ス登録済み情報の取得メソッド（ APIGetRegisteredInfoFromRegistry メ ソッド）の実行により、登録済みのシリアルNo.が当プロパティに設定されます。
プロキシサーバーの使用区分
プロキシサーバーのアドレス プ ロ キ シ
サーバー
プロキシサーバーのポート
プロキシサーバーのユーザ 使用時「認証レスキュー！.NET」 ユーザーズガイド- 252 -

UI
Code

Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code
Code

名
プロキシサーバーのパスワ
ード
APIDisabledNICIgnore
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
APIEncryptionPassword
暗号化時のパスワード
APIEncryptionSaltString
暗号化時の Salt 文字列
APITrialPeriod
猶予（試用）日数（0：猶予期間なし）
APIUseCpuInfo
CPU 情報の使用区分
APIUseMacAddress
MAC アドレスの使用区分
APIVendorsProductStartRegistryKeyPath
ベンダアプリケーション開始レジストリキーパス
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分
APIProxyServerPassword※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
フローティングライセンス使用開始を実行します。
このメソッドは、APITrialPeriod プロパティが 0 以上に設定されている場合、実行できません。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」、「プロダクト ID」、「シリアル No.」は、（レジストリからの）フローティングライ
センス登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行で設定され「認証レスキュー！.NET」 ユーザーズガイド- 253 -

る認証 ID プロパティ（APICertificationID プロパティ）、プロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.プロパティ（APISerialNo プロパティ）でそれぞれ取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1] （ レ ジ ス ト リ か ら の ） フ ロ ー テ ィ ン グ ラ イ セ ン ス 登 録 済 み 情 報 の 取 得 メ ソ ッ ド（APIGetRegisteredInfoFromRegistry メソッド）を実行します。これにより、認証 ID プロパティ、プロ
ダクト ID プロパティ、シリアル No.プロパティに各値が設定されます。
[2]認証 ID プロパティ、プロダクト ID プロパティ、シリアル No.プロパティの各値を画面に表示します。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[4] 上 記 の 「 想 定 UI 画 面 」 の 「 使 用 開 始 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIFloatingLicenseStart メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 254 -

APIGenerationOfNewCertificationID メソッド【機能】
認証登録時に必要な、新しい認証 ID を生成します。
【構文】<VB.NET>
Public Function APIGenerationOfNewCertificationID() As Boolean<C#>public bool APIGenerationOfNewCertificationID()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIWebServiceCheckPassword
APIVendorsProductStartRegistryKeyPath

処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
Web サービス確認パスワード
ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
認証登録時に必要な、新しい認証 ID を生成します。
[1]このメソッドの戻り値は成功か失敗（True/False）です。
[2]認証登録済みの場合は、当メソッドは失敗します。
[3]このメソッドの成功時のみ、認証 ID プロパティ（APICertificationID プロパティ）に新しく生成された認証 ID が設定されます。

「認証レスキュー！.NET」 ユーザーズガイド- 255 -

「認証レスキュー！.NET」 ユーザーズガイド- 256 -

APIGetFreeItem メソッド
【機能】
プロダクト ID とシリアル No.を指定して、ActivationKey テーブルより自由入力項目を取得します。
【構文】<VB.NET>
Public Function APIGetFreeItem () As Boolean<C#>public bool APIGetFreeItem ()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容

※

UI
UI
UI
UI
UI
UI
UI
Code
Code
Code
Code
Code
Code

APIProductID
APISerialNo
APIUseProxyServer
APIProxyServerAddress（認証登録する）プロダクト ID（認証登録する）シリアル No.
プロキシサーバーの使用区分
プロキシサーバーのアドレ プ ロ キ シ サ
スーバー使用
APIProxyServerPort
プロキシサーバーのポート 時
APIProxyServerUserName
プロキシサーバーのユー
ザ名
APIProxyServerPassword
プロキシサーバーのパス
ワード
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
プロダクト ID とシリアル No.を指定して、ActivationKeyTable より自由入力項目を取得します。当メソ「認証レスキュー！.NET」 ユーザーズガイド- 257 -

ッド（APIGetFreeItem メソッド）実行後、APIFreeItem1～APIFreeItem5 プロパティに値が設定されます。

「認証レスキュー！.NET」 ユーザーズガイド- 258 -

APIGetProductIdSerialNoList メソッド【機能】
外部データベースとのリンク用キー項目を指定し ActivationKey テーブルよりプロダクト ID とシリア
ル No.のペア文字列の列挙を取得します。
【構文】<VB.NET>
Public Function APIGetProductIdSerialNoList () As Integer<C#>public int APIGetProductIdSerialNoList ()

【引数】
なし
【戻り値】
取得したプロダクト ID とシリアル No.のペアリングの数。
エラー時は 0 が設定され、戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー
内容がセットされます。
また、APIProductIdSerialNoList プロパティに取得したプロダクト ID とシリアル No.をデリミタのカンマ（，）で区切った文字列が設定されます。該当するデータが存在しない時は、""（空文字列）が設定されます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容

※

UI

UI
UI
UI
UI
UI
Code
Code
Code
Code
Code
Code

APIExternalLinkKey

APIGetProductIdSerialNoList メソッド 実
行時の外部データベースとのリンク用キー項目を設定します。
APIUseProxyServer
プロキシサーバーの使用区分
APIProxyServerAddress
プロキシサーバーのアドレス プ ロ キ シ
サーバー
APIProxyServerPort
プロキシサーバーのポート
APIProxyServerUserName
プロキシサーバーのユーザ 使用時
名
APIProxyServerPassword
プロキシサーバーのパスワ
ード
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ「認証レスキュー！.NET」 ユーザーズガイド- 259 -

【解説】APIExternalLinkKey プロパティに外部データベースとのリンク用キーを指定し ActivationKey テー
ブルよりプロダクト ID とシリアル No.のペア文字列の列挙を取得します。
認証レスキュー！とは別の外部データベースとのリンク用キーを APIExternalLinkKey プロパティに設定し、当メソッド（APIGetProductIdSerialNoList メソッド）を実行すると、認証レスキュー！のデー
タベースの ActivationKey テーブルより該当するプロダクト ID とシリアル No.のペア文字列の列挙
をデリミタ付きで APIProductIdSerialNoList プロパティに設定して返します。
プロダクト ID とシリアル No.のペア文字列の列挙は、たとえば次のような文字列です。
デリミタはカンマ（，）です。
1111-1111-1111,aaaa1111,22222-22222-22222,bbbb2222,33333-33333-33333,cccc3333
この例では次の 3 組のプロダクト ID とシリアル No.が返されました。
プロダクト ID =”11111-11111-11111” シリアル No.=”aaaa1111”
プロダクト ID =”22222-22222-22222” シリアル No.=”bbbb2222”
プロダクト ID =”33333-33333-33333” シリアル No.=”cccc3333”
当メソッド（APIGetProductIdSerialNoList メソッド）の具体的な利用方法の例は次のようなものがあります。
貴社のアプリケーション内でエンドユーザに対し、複数のプロダクト ID とシリアル No.のペアを一括で認証登録させたい場合を考えます。
手順 1
貴社のアプリケーション内の一括認証処理の UI 上でエンドユーザにユニークな「リンク用キー」（例：
ユーザ ID）を入力させる。
手順 2
エンドユーザに入力させた「リンク用キー」を APIExternalLinkKey プロパティに設定し、他の必須設
定プロパティの設定後、当メソッド（APIGetProductIdSerialNoList メソッド）を実行する。
手順 3
認証レスキュー！の認証用 DLL が、「Activationkey テーブル」上のその「リンク用キー」に該当する
全レコード分のプロダクト ID とシリアル No.の列挙をデリミタ付きの文字列として
APIProductIdSerialNoList プロパティに設定して返す。
手順 4
一括認証処理の UI 上にそれらの返されたプロダクト ID とシリアル No.を一覧表示し、エンドユーザの確認を求めた後、インターネットによる認証登録（APIActivateRegisterInternet メソッド）で認証登録する。

「認証レスキュー！.NET」 ユーザーズガイド- 260 -

APIGetProxyDataForExpirationDate メソッド【機能】
代理有効期限取得データを取得します。
【構文】<VB.NET>
Public Function APIGetProxyDataForExpirationDate() As Boolean<C#>public bool APIGetProxyDataForExpirationDate ()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

UI

APIProxyDataPath

Code
Code

APIEncryptionPassword
APIEncryptionSaltString（有効期限を更新する）代理有効期限取得データのパス
ファイルの拡張子は「.NRS」です。
暗号化時のパスワード
暗号化時の Salt 文字列※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
代理有効期限取得データを取得します。
[1]このメソッドの戻り値は成功か失敗（True/False）です。
[2]代理認証データのパスや内容が正しくない場合は、当メソッドは失敗します。
[3]このメソッドの成功時のみ、次表の各プロパティに値が設定されます。
代理有効期限更新関連のメソッドによって、事前に当メソッド（APIGetProxyDataForExpirationDateメソッド）の実行が必要かどうかや設定されるプロパティが異なります。
◆当メソッド（APIGetProxyDataForExpirationDate メソッド）の利用形態
事
プロパティ
代理有効期限 前 プロダクト ID シリアル No. 現 在 の 有 効 新 し い 有 効の プロパティ プロパティ 期限（取得 期限（取得更新
関連のメソッド 当 （ APIProduct （ APISerialN 専 用 ） 専 用 ）
メ ID プロパテ o プロパティ） （ APICurrent （ APINewExp「認証レスキュー！.NET」 ユーザーズガイド- 261 -

ソ ィ）
ッ
ド
の
実
行
代理有効期限 不 設定不要
更新準備
要
（ APIPreparati
onOfProxyUpd
ateOfExpiratio
nDate メソッド）
代理有効期限 必 当 メ ソ ッ ド で取得
要 設定（APIGetProxy
UpdateOfExpirationDateメソッド）
代理有効期限 必 当 メ ソ ッ ド で
更新確定
要 設定
（APIDetermin
ationOfProxyU
pdateOfExpira
tionDateメソッド）

ExpirationDa irationDate
te プ ロ パ テ プロパティ）
ィ）

設定不要

設定不要

設定不要

当 メ ソ ッ ド で 当 メ ソ ッ ド で APIGetProxyU
pdateOfExpir
設定
設定
ationDate

メソッドより取得
当メソッドで 当メソッドで 当メソッドで
設定
設定
設定

[4]当メソッドの実行には上記の【必須設定プロパティ】にある、代理有効期限取得データのパス（APIProxyDataPath プロパティ）に適切な設定が必要です。

「認証レスキュー！.NET」 ユーザーズガイド- 262 -

APIGetProxyDataForRegister メソッド【機能】
代理認証登録データを取得します。
（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function APIGetProxyDataForRegister () As Boolean<C#>public bool APIGetProxyDataForRegister ()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

Code
Code
UI

APIEncryptionPassword
APIEncryptionSaltString
APIProxyDataPath

暗号化時のパスワード
暗号化時の Salt 文字列（認証登録する）代理認証データのパス。
ファイルの拡張子は「.NRS」です。

※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
代理認証登録データを取得します。
[1]このメソッドの戻り値は成功か失敗（True/False）です。
[2]代理認証データのパスや内容が正しくない場合は、当メソッドは失敗します。
[3]このメソッドの成功時のみ、次表の各プロパティに値が設定されます。
代理認証関連のメソッドによって、事前に当メソッド（APIGetProxyDataForRegister メソッド）の実行が必要かどうかや設定されるプロパティが異なります。
◆当メソッド（APIGetProxyDataForRegister メソッド）の利用形態
代理認証
関連のメソッド

事前の当
メソッドの
実行

プロパティ
認証 ID プロパティ プロダクト ID プロ シリアル No. プ（APICertificationID パ
ティ ロ パ テ ィプロパティ）（APIProductID プ （APISerialNo プ「認証レスキュー！.NET」 ユーザーズガイド- 263 -

代理認証登録準備
不要（ APIProxyActivateRegi
sterPrepare メソッド）
代理認証登録実行必要（ APIProxyActivateRegi
sterExecute メソッド）
代理認証登録確定
必要（ APIProxyActivateRegi
sterFix メソッド）

設定不要

ロパティ）
設定不要

ロパティ）
設定不要

当メソッドで設定

UI 画面上などか UI 画 面 上 な ど
ら設定
から設定

当メソッドで設定

当メソッドで設定

当メソッドで設
定[4]当メソッドの実行には上記の【必須設定プロパティ】にある、代理認証データパスプロパティ（APIProxyDataPath プロパティ）に適切な設定が必要です。

「認証レスキュー！.NET」 ユーザーズガイド- 264 -

APIGetProxyDataForRemove メソッド【機能】
代理認証解除データを取得します。
（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function APIGetProxyDataForRemove () As Boolean<C#>public bool APIGetProxyDataForRemove ()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

Code
Code
UI

APIEncryptionPassword
APIEncryptionSaltString
APIProxyDataPath

暗号化時のパスワード
暗号化時の Salt 文字列（認証登録する）代理認証データのパス。
ファイルの拡張子は「.NRS」です。

※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
代理認証解除データを取得します。
[1]このメソッドの戻り値は成功か失敗（True/False）です。
[2]代理認証データのパスや内容が正しくない場合は、当メソッドは失敗します。
[3]このメソッドの成功時のみ、次表の各プロパティに値が設定されます。
代理認証関連のメソッドによって、事前に当メソッド（APIGetProxyDataForRemove メソッド）の実行が必要かどうかや設定されるプロパティが異なります。
◆当メソッド（APIGetProxyDataForRemove メソッド）の利用形態
代理認証
関連のメソッド

事前の当
メソッドの
実行

プロパティ
認証 ID プロパティ プロダクト ID プロ シリアル No. プ（APICertificationID パ
ティ ロ パ テ ィプロパティ）（APIProductID プ （APISerialNo プ「認証レスキュー！.NET」 ユーザーズガイド- 265 -

代理認証解除準備
不要（ APIProxyActivateRem
ovePrepare メソッド）
代理認証解除実行
必要（ APIProxyActivateRem
oveExecute メソッド）

設定不要

ロパティ）
設定不要

ロパティ）
設定不要

当メソッドで設定

当メソッドで設定

当メソッドで設
定[4]当メソッドの実行には上記の【必須設定プロパティ】にある、代理認証データパスプロパティ（APIProxyDataPath プロパティ）に適切な設定が必要です。

「認証レスキュー！.NET」 ユーザーズガイド- 266 -

APIGetProxyUpdateOfExpirationDate メソッド
【機能】
「代理有効期限/取得」を実行します。（代理 PC で利用）
【構文】
<VB.NET>
Public Function APIGetProxyUpdateOfExpirationDate() As Boolean<C#>public bool APIGetProxyUpdateOfExpirationDate()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPIProxyDataPath

UI

APIProductID

UI

APISerialNo

UI
UI
UI
UI

APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName

UI

APIProxyServerPassword（有効期限を更新する）代理有効期限取得データのパスファイルの拡張子は「.NRS」です。
（代理有効期限を取得する）プロダクト ID
代理有効期限取得データの取得メソッド（APIGetProxyDataForExpirationDate メソッド）の実行により、代理有効期限取得データから取得したプロダクト ID が当プロパ
ティに設定されます。
（代理有効期限を取得する）シリアル No.
代理有効期限取得データの取得メソッド（APIGetProxyDataForExpirationDate メソッド）の実行により、代理有効期限取得データから取得したシリアル No.が当プロパ
ティに設定されます。
プロキシサーバーの使用区分
プロキシサーバーのアドレス プ ロ キ シ
サーバー
プロキシサーバーのポート
プロキシサーバーのユーザ 使用時
名
プロキシサーバーのパスワ
ード「認証レスキュー！.NET」 ユーザーズガイド- 267 -

Code
Code
Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APIWebServiceBasicAuthenticationPassword

暗号化時のパスワード
暗号化時の Salt 文字列
Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「代理有効期限/取得」を実行します。（代理 PC で利用）
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「プロダクト ID」、「シリアル No.」、「現在の有効期限」は、代理有効期限取得データの取得メソッド（APIGetProxyDataForExpirationDate メソッド）の実行で設定されるプロダクト ID プロパ
ティ（APIProductID プロパティ）、シリアル No.プロパティ（APISerialNo プロパティ）、現在の有効期限
プロパティ（APICurrentExpirationDate プロパティ）で取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1] 代理有効期限取得データパスをエンドユーザに画面より入力させ、代理有効期限取得データパ
スプロパティ（APIProxyDataPath プロパティ）に設定します。この際、ファイルの拡張子は「.NRS」とします。
[2] 代理有効期限取得データの取得メソッド（APIGetProxyDataForExpirationDate メソッド）を実行し「認証レスキュー！.NET」 ユーザーズガイド- 268 -

ます。
これに より、プロダクト ID プロパテ ィ（ APIProductID プロパテ ィ）、シリ アル No. プロパテ ィ（APISerialNo プロパティ）、現在の有効期限プロパティ（APICurrentExpirationDate プロパティ）に代
理有効期限取得データから取得したプロダクト ID、プロパティ、現在の有効期限が設定されます。
その内容を画面に表示します。この内容表示そのものは必須ではありません。
[3] 代理有効期限取得データから取得したプロダクト ID とシリアル No.をプロダクト ID プロパティ（APIProductID プロパティ）とシリアル No. プロパティ（APISerialNo プロパティ）にそれぞれ設定します。あるいは、別の方法で結果としてプロダクト ID プロパティ（APIProductID プロパティ）とシリアル
No. プロパティ（APISerialNo プロパティ）にそれぞれ認証登録するプロダクト ID とシリアル No.を設定します。
[4]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[5] 上 記 の 「 想 定 UI 画 面 」 の 「 取 得 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIGetProxyUpdateOfExpirationDate メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 269 -

APIGetRegisteredInfoFromRegistry メソッド
【機能】
レジストリから認証登録済みの情報を取得します。
【構文】<VB.NET>
Public Function APIGetRegisteredInfoFromRegistry() As Boolean<C#>public bool APIGetRegisteredInfoFromRegistry()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIWebServiceCheckPassword
APIVendorsProductStartRegistryKeyPath

処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
Web サービス確認パスワード
ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
レジストリから認証登録済みの情報を取得します。
[1]このメソッドの戻り値は成功か失敗（True/False）。
[2]認証されていない場合は、当メソッドは失敗します。
[3]このメソッドの成功時のみ、次のプロパティに認証登録済みの各情報が設定されます。
・プロダクト ID（APIProductID プロパティ）
・シリアル No. （APISerialNo プロパティ）「認証レスキュー！.NET」 ユーザーズガイド- 270 -

・認証 ID（APICertificationID プロパティ）
・ライセンスキー（APILicenseKey プロパティ）
・現在の有効期限（APICurrentExpirationDate）
・フローティングライセンス状況（APIFloatingLicenseState プロパティ）（0：未登録 1：登録済）[4]これらのプロパティは、正常に読み込みが成功しない限り、初期値（空文字列または 0）が設定されます。

「認証レスキュー！.NET」 ユーザーズガイド- 271 -

APIGetRegisteredInfoFromRegistry2 メソッド
【機能】
レジストリから認証登録済みの情報を取得します。
Windows の管理者でなくても実行可能です。
【構文】<VB.NET>
Public Function APIGetRegisteredInfoFromRegistry2() As Boolean<C#>public bool APIGetRegisteredInfoFromRegistry2()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※Code

APIDisabledNICIgnore

Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APISelectRunAppDatePathFlag

Code
Code
Code
Code
Code

APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIWebServiceCheckPassword
APIVendorsProductStartRegistryKeyPath

処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列「アプリ起動日」の読み込み/書き込み場
所の切り替えフラグ
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
Web サービス確認パスワード
ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
以下の機能以外は従来の APIGetRegisteredInfoFromRegistry メソッドと同等です。
APISelectRunAppDatePathFlag プロパティ値による場所+従来のAPIVendorsProductStartRegistryKeyPath プロパティ値の場所に「アプリ起動日」の読み込み/書き込みを行います。
このメソッドは、ユーザ様からのご要望で追加いたしました。
「認証レスキュー！.NET」 ユーザーズガイド- 272 -Windows の管理者でなくても APIActivateStatusCheck2 メソッドを使用して認証状態を確認後、認証情報を取得するために、このメソッドが必要となり追加されました。

「認証レスキュー！.NET」 ユーザーズガイド- 273 -

APIGetRegisteredInfoFromWeb メソッド
【機能】
インターネットを使用して ActivationKeyTable から「ライセンス数」「有効期限の利用」「有効期限」を、
ActivationDataTable から「認証 ID」「認証日時（作成日）」を取得します。
【構文】<VB.NET>
Public Function APIGetRegisteredInfoFromWeb() As String<C#>public string APIGetRegisteredInfoFromWeb()

【引数】
なし
【戻り値】
①設定ライセンス数②認証済ライセンス数③有効期限有無④有効期限②分の「認証 ID」と「認証日時（作成日）」
として文字列で返します。
該当する認証キーが存在しない場合は、空を返します。
また、各項目の値を デリミタの カンマ（，）で区切った文字列が設定されます。
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容

※

UI
UI
UI
UI
UI
UI
UI
Code
Code
Code
Code

APIProductID
APISerialNo
APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName（認証登録する）プロダクト ID（認証登録する）シリアル No.
プロキシサーバーの使用区分
プロキシサーバーのアドレス プ ロ キ シ
サーバー
プロキシサーバーのポート
プロキシサーバーのユーザ 使用時
名
APIProxyServerPassword
プロキシサーバーのパスワ
ード
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード（基本認証使用時）
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名（基本認証使用時）APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト「認証レスキュー！.NET」 ユーザーズガイド- 274 -

Code
Code

APIWebServiceURL
APIWebServiceUseBasicAuthentication

Web サービスの URL
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
インターネットを使用して ActivationKeyTable から「ライセンス数」「有効期限の利用」「有効期限」を、
ActivationDataTable から「認証 ID」「認証日時（作成日）」を取得します。
◆想定UI画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

◆処理手順
一連の処理の手順は次の通りです。
[1]プロダクト ID とシリアル No. をエンドユーザに画面より入力させ、プロダクト ID プロパティ（ APIProductID プロパティ）とシリアル No. プロパティ（ APISerialNo プロパティ）にそれぞれ設定します。あるいは、別の方法で結果としてプロダクト ID プロパティ（ APIProductID プロパティ）とシリアル No プロパティ（ APISerialNo プロパティ）にそれぞれ認証登録するプロダクト ID とシリアル No.を設定します。
[2]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[3] 上 記 の 「 想 定 UI 画 面 」 の 「 取 得 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIGetRegisteredInfoFromWeb メソッド）を実行します。
「認証レスキュー！.NET」 ユーザーズガイド- 275 -

取得した文字列の列挙は、たとえば次のような文字列です。
デリミタはカンマ（，）です。
1,1,0,,50533-21818,2014/03/24 15:42:00
この例では、設定ライセンス 1 の認証済みの結果が返されました。
設定ライセンス数=”1”
認証済ライセンス数=”1”
有効期限有無=”0”
有効期限=””
認証 ID=”50533-21818”
認証日時（作成日）=”2014/03/24 15:42:00”「認証レスキュー！.NET」 ユーザーズガイド- 276 -

APIPreparationOfProxyUpdateOfExpirationDate メソッド
【機能】
「代理有効期限取得/準備」を実行します。（有効期限を更新したい PC で利用）
【構文】
<VB.NET>
Public Function APIPreparationOfProxyUpdateOfExpirationDate() As Boolean<C#>public bool APIPreparationOfProxyUpdateOfExpirationDate()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容

※

UI

Code
Code
Code
Code
Code
Code
Code
Code

APIProxyDataPath（有効期限を更新する）代理有効期限取得データのパス
ファイルの拡張子は「.NRS」です。
APIDisabledNICIgnore
処理を高速化するため、無効になっている
NIC（Network Interface Card）を無視します。
APIEncryptionPassword
暗号化時のパスワード
APIEncryptionSaltString
暗号化時の Salt 文字列
APITrialPeriod
猶予（試用）日数APIUseCpuInfo
CPU 情報の使用区分
APIUseMacAddress
MAC アドレスの使用区分
APIWebServiceCheckPassword
Web サービス確認パスワード
APIVendorsProductStartRegistryKeyPath ベンダアプリケーション開始レジストリキーパ
ス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「代理有効期限取得/準備」を実行します。（有効期限を更新したい PC で利用）
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

「認証レスキュー！.NET」 ユーザーズガイド- 277 -

◆処理手順
一連の処理の手順は次の通りです。
[1] 代理有効期限取得データパスをエンドユーザに画面より入力させ、代理有効期限取得データパ
スプロパティ（APIProxyDataPath プロパティ）に設定します。この際、ファイルの拡張子は「.NRS」とします。
[2]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[3] 上 記 の 「 想 定 UI 画 面 」 の 「 保 存 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIPreparationOfProxyUpdateOfExpirationDate メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 278 -

APIProxyActivateRegisterExecute メソッド
【機能】
「代理認証登録/実行」を実行します。（代理 PC で利用）（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function APIProxyActivateRegisterExecute() As Boolean<C#>public bool APIProxyActivateRegisterExecute()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPIProxyDataPath

UI

APICertificationID

UI
UI
UI
UI
UI
UI
UI

APIProductID
APISerialNo
APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName
APIProxyServerPassword

Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo（認証登録する）代理認証データのパス。
ファイルの拡張子は「.NRS」です。
（認証登録する）認証 ID（取得専用）。
代理認証登録データの取得メソッド（APIGetProxyDataForRegister メソッド）の実行により、代理認証データから取得
した認証 ID が当プロパティに設定されます。
（認証登録する）プロダクト ID（認証登録する）シリアル No.
プロキシサーバーの使用区分
プロキシサーバーのアドレス
プロキ
シサー
プロキシサーバーのポート
プロキシサーバーのユーザ名 バ ー 使
プロキシサーバーのパスワー 用 時 有
効ド
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分「認証レスキュー！.NET」 ユーザーズガイド- 279 -

Code
Code

APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

Code
Code
Code
Code
Code
Code

APIWebServiceBasicAuthenticationPassword
APIWebServiceBasicAuthenticationUserName
APIWebServiceCheckPassword
APIWebServiceTimeout
APIWebServiceURL
APIWebServiceUseBasicAuthentication

MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキーパス
Web サービス時の基本認証パスワード
Web サービス時の基本認証ユーザ名
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「代理認証登録/実行」を実行します。（代理 PC で利用）
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」は、代理認証登録データの取得メソッド（APIGetProxyDataForRegister メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）で取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1]代理認証データパスをエンドユーザに画面より入力させ、代理認証データパスプロパティ（APIProxyDataPath プロパティ）に設定します。この際、ファイルの拡張子は「.NRS」とします。
[2]代理認証登録データの取得メソッド（APIGetProxyDataForRegister メソッド）を実行します。
これにより、認証 ID プロパティ（APICertificationID プロパティ）に代理認証登録データから取得した
認証 ID が設定されます。
その内容を画面に表示します。この内容表示そのものは必須ではありません。

「認証レスキュー！.NET」 ユーザーズガイド- 280 -

[3]プロダクト ID とシリアル No.をエンドユーザに画面より入力させ、プロダクト ID プロパティ（APIProductID プロパティ）とシリアル No. プロパティ（APISerialNo プロパティ）にそれぞれ設定します。あるいは、別の方法で結果としてプロダクト ID プロパティ（APIProductID プロパティ）とシリアル
No. プロパティ（APISerialNo プロパティ）にそれぞれ認証登録するプロダクト ID とシリアル No.を設定します。
[4]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[5] 上 記 の 「 想 定 UI 画 面 」 の 「 登 録 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIProxyActivateRegisterExecute メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 281 -

APIProxyActivateRegisterFix メソッド
【機能】
「代理認証登録/確定」を実行します。（認証登録したい PC で利用）（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function APIProxyActivateRegisterFix() As Boolean<C#>public bool APIProxyActivateRegisterFix()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPIProxyDataPath

UI

APICertificationID

UI

APIProductID

UI

APISerialNo

Code

APIDisabledNICIgnore

Code
Code

APIEncryptionPassword
APIEncryptionSaltString（認証登録する）代理認証データのパス
ファイルの拡張子は「.NRS」です。
（認証登録する）認証 ID（取得専用）。
代理認証登録データの取得メソッド（APIGetProxyDataForRegister メソッド）の実
行により、代理認証データから取得した認証
ID が当プロパティに設定されます。
（認証登録する）プロダクト ID
代理認証登録データの取得メソッド（APIGetProxyDataForRegister メソッド）の実
行により、代理認証データから取得したプロ
ダクト ID が当プロパティに設定されます。
（認証登録する）シリアル No.
代理認証登録データの取得メソッド（APIGetProxyDataForRegister メソッド）の実
行により、代理認証データから取得したシリ
アル No.が当プロパティに設定されます。
処理を高速化するため、無効になっている
NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列「認証レスキュー！.NET」 ユーザーズガイド- 282 -

Code
Code
Code
Code
Code

APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIWebServiceCheckPassword
APIVendorsProductStartRegistryKeyPath

猶予（試用）日数（0：猶予期間なし）
CPU 情報の使用区分
MAC アドレスの使用区分
Web サービス確認パスワード
ベンダアプリケーション開始レジストリキーパ
ス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「代理認証登録/確定」を実行します。（認証登録したい PC で利用）
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」、「プロダクト ID」、「シリアル No.」は、代理認証登録データの取得メソッド（APIGetProxyDataForRegister メソッド）の実行で設定される認証 ID プロパティ（APICertificationID
プロパテ ィ） 、プロダク ト ID プロパテ ィ（ APIProductID プロパテ ィ） 、シ リ ア ル No. プロパテ ィ（APISerialNo プロパティ）でそれぞれ取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1]代理認証データパスをエンドユーザに画面より入力させ、代理認証データパスプロパティ（APIProxyDataPath プロパティ）に設定します。この際、ファイルの拡張子は「.NRS」とします。
[2]代理認証登録データの取得メソッド（APIGetProxyDataForRegister メソッド）を実行します。
これに より、 認証 ID プロパテ ィ（ APICertificationID プロパテ ィ）、プロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.プロパティ（APISerialNo プロパティ）に代理認証データから取得した認証 ID、プロダクト ID、シリアル No.それぞれが設定されます。
それらの内容を画面に表示します。この内容表示そのものは必須ではありません。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

「認証レスキュー！.NET」 ユーザーズガイド- 283 -

[5] 上 記 の 「 想 定 UI 画 面 」 の 「 登 録 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIProxyActivateRegisterFix メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 284 -

APIProxyActivateRegisterPrepare メソッド
【機能】
「代理認証登録/準備」を実行します。（認証登録したい PC で利用）（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function APIProxyActivateRegisterPrepare() As Boolean<C#>public bool APIProxyActivateRegisterPrepare()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPIProxyDataPath

Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIWebServiceCheckPassword
APIVendorsProductStartRegistryKeyPath（認証登録する）代理認証データのパス
ファイルの拡張子は「.NRS」です。
処理を高速化するため、無効になっている
NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数CPU 情報の使用区分
MAC アドレスの使用区分
Web サービス確認パスワード
ベンダアプリケーション開始レジストリキーパ
ス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「代理認証登録/準備」を実行します。（認証登録したい PC で利用）
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

「認証レスキュー！.NET」 ユーザーズガイド- 285 -

◆処理手順
一連の処理の手順は次の通りです。
[1]代理認証データパスをエンドユーザに画面より入力させ、代理認証データパスプロパティ（APIProxyDataPath プロパティ）に設定します。この際、ファイルの拡張子は「.NRS」とします。
[2]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[3] 上 記 の 「 想 定 UI 画 面 」 の 「 保 存 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIProxyActivateRegisterPrepare メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 286 -

APIProxyActivateRemoveExecute メソッド
【機能】
「代理認証解除/実行」を実行します。（代理 PC で利用）（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function APIProxyActivateRemoveExecute() As Boolean<C#>public bool APIProxyActivateRemoveExecute()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPIProxyDataPath

UI

APICertificationID

UI

APIProductID

UI

APISerialNo

UI
UI

APIUseProxyServer
APIProxyServerAddress（認証登録する）代理認証データのパス
ファイルの拡張子は「.NRS」です。
（認証登録する）認証 ID（取得専用）。
代理認証解除データの取得メソッド（APIGetProxyDataForRemove メソッド）の実行により、代理認証データから取得した
認証 ID が当プロパティに設定されます。
（認証登録する）プロダクト ID
代理認証解除データの取得メソッド（APIGetProxyDataForRemove メソッド）の実行により、代理認証データから取得した
プロダクト ID が当プロパティに設定されます。
（認証登録する）シリアル No.
代理認証解除データの取得メソッド（APIGetProxyDataForRemove メソッド）の実行により、代理認証データから取得した
シリアル No.が当プロパティに設定されます。
プロキシサーバーの使用区分
プロキシサーバーのアドレス
プロキ「認証レスキュー！.NET」 ユーザーズガイド- 287 -UI
UI
UI

APIProxyServerPort
APIProxyServerUserName
APIProxyServerPassword

Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

Code
Code
Code
Code
Code
Code

プロキシサーバーのポート
プロキシサーバーのユーザ名
プロキシサーバーのパスワード

シサー
バー使
用時有
効

暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキーパス
APIWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワード
APIWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名
APIWebServiceCheckPassword
Web サービス確認パスワード
APIWebServiceTimeout
Web サービスのタイムアウト
APIWebServiceURL
Web サービスの URL
APIWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「代理認証解除/実行」を実行します。（代理 PC で利用）
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」、「プロダクト ID」、「シリアル No.」は、代理認証解除データの取得メソッド（APIGetProxyDataForRemove メソッド）の実行で設定される認証 ID プロパティ（APICertificationID
プロパティ）、プロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.プロパティ（APISerialNo プロパティ）でそれぞれ取得できます。
◆処理手順
一連の処理の手順は次の通りです。
「認証レスキュー！.NET」 ユーザーズガイド- 288 -

[1]代理認証データパスをエンドユーザに画面より入力させ、代理認証データパスプロパティ（APIPr
oxyDataPath プロパティ）に設定します。この際、ファイルの拡張子は「.NRS」とします。
[2]代理認証解除データの取得メソッド（APIGetProxyDataForRemove メソッド）を実行します。
これにより、認証 ID プロパティ（APICertificationID プロパティ）、プロダクト ID プロパティ（APIProdu
ctID プロパティ）、シリアル No.プロパティ（APISerialNo プロパティ）に代理認証データから取得した
認証 ID、プロダクト ID、シリアル No.それぞれが設定されます。
それらの内容を画面に表示します。この内容表示そのものは必須ではありません。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[4] 上 記 の 「 想 定 UI 画 面 」 の 「 解 除 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIProxyActivateRemoveExecute メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 289 -

APIProxyActivateRemovePrepare メソッド
【機能】
「代理認証解除/準備」を実行します。（認証登録したい PC で利用）（代理認証機能については、「代理認証機能について」を参照）【構文】<VB.NET>
Public Function APIProxyActivateRemovePrepare() As Boolean<C#>public bool APIProxyActivateRemovePrepare()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※UIAPIProxyDataPath

Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIWebServiceCheckPassword
APIVendorsProductStartRegistryKeyPath（認証登録する）代理認証データのパス
ファイルの拡張子は「.NRS」です。
処理を高速化するため、無効になっている
NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数CPU 情報の使用区分
MAC アドレスの使用区分
Web サービス確認パスワード
ベンダアプリケーション開始レジストリキーパ
ス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「代理認証解除/準備」を実行します。（認証登録したい PC で利用）
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

「認証レスキュー！.NET」 ユーザーズガイド- 290 -

◆処理手順
一連の処理の手順は次の通りです。
[1]代理認証データパスをエンドユーザに画面より入力させ、代理認証データパスプロパティ（APIProxyDataPath プロパティ）に設定します。この際、ファイルの拡張子は「.NRS」とします。
[2]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[3] 上 記 の 「 想 定 UI 画 面 」 の 「 保 存 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIProxyActivateRemovePrepare メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 291 -APIReadProxyServerInfoFromRegistry メソッド
【機能】
レジストリからプロキシサーバーの情報を取得します。
【構文】<VB.NET>
Public Function APIReadProxyServerInfoFromRegistry () As Boolean<C#>public bool APIReadProxyServerInfoFromRegistry ()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容

※

Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APIVendorsProductStartRegistryKeyPath

暗号化時のパスワード
暗号化時の Salt 文字列
ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
レジストリからプロキシサーバーの情報を取得します。
[1]このメソッドの戻り値は成功か失敗（True/False）。
[2] プロキシサーバーのユーザ名とパスワードを暗号化されおり復号化が失敗すると、当メソッドは失敗します。また、レジストリの読み込みで何らかの原因で失敗すると、当メソッドは失敗します。
[3]このメソッドの成功時のみ、次のプロパティにプロキシサーバーの各情報が設定されます。
・プロキシサーバーのアドレス（APIProxyServerAddress）
・プロキシサーバーのパスワード（APIProxyServerPassword）
・プロキシサーバーのポート（APIProxyServerPort）
・プロキシサーバーのユーザ名（APIProxyServerUserName）
・プロキシサーバーの使用区分（APIUseProxyServer）[4]これらのプロパティは、正常に読み込みが成功しない限り、初期値（空文字列）が設定されます。
「認証レスキュー！.NET」 ユーザーズガイド- 292 -

「認証レスキュー！.NET」 ユーザーズガイド- 293 -APIRestoreCancelStatus メソッド【機能】
「認証解除状態回復」を実行します。
【構文】<VB.NET>
Public Function APIRestoreCancelStatus() As Boolean<C#>public bool APIRestoreCancelStatus()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

UI

APICertificationID

UI

APIProductID

UI

APISerialNo

UI
UI
UI
UI

APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName（登録解除する）認証 ID（取得専用）。
（レジストリからの）認証登録済み情報の
取
得
メ
ソ
ッ
ド
（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みの認証 ID
が当プロパティに設定されます。
（認証解除する）プロダクト ID（レジストリからの）認証登録済み情報の
取
得
メ
ソ
ッ
ド
（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みのプロダク
ト ID が当プロパティに設定されます。
（認証解除する）シリアル No.
（レジストリからの）認証登録済み情報の
取
得
メ
ソ
ッ
ド
（APIGetRegisteredInfoFromRegistry メソッド）の実行により、登録済みのシリアルNo.が当プロパティに設定されます。
プロキシサーバーの使用区分
プロキシサーバーのアドレス
プロキ
シサー
プロキシサーバーのポート
プロキシサーバーのユーザ名 バ ー 使「認証レスキュー！.NET」 ユーザーズガイド- 294 -UI

APIProxyServerPassword

Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

Code
Code
Code
Code
Code
Code

APIWebServiceBasicAuthenticationPassword
APIWebServiceBasicAuthenticationUserName
APIWebServiceCheckPassword
APIWebServiceTimeout
APIWebServiceURL
APIWebServiceUseBasicAuthentication

プロキシサーバーのパスワー 用 時 有
ド
効
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキーパス
Web サービス時の基本認証パスワード
Web サービス時の基本認証ユーザ名
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「認証解除状態回復」を実行します。
「ライセンス認証解除」でデータベースの解除に成功したが、エンドユーザ PC での認証解除が失敗した状態になった場合に、このメソッドによる処理でエンドユーザの操作でその状態を回復しエンド
ユーザ PC を認証解除状態とします。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

この画面上の「認証 ID」、「プロダクト ID」、「シリアル No.」は、（レジストリからの）認証登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）、プロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.
プロパティ（APISerialNo プロパティ）でそれぞれ取得できます。

「認証レスキュー！.NET」 ユーザーズガイド- 295 -

◆処理手順
一連の処理の手順は次の通りです。
[1]（レジストリからの）認証登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）
を実行します。これにより、認証 ID プロパティ、プロダクト ID プロパティ、シリアル No.プロパティに各値が設定されます。
[2]認証 ID プロパティ、プロダクト ID プロパティ、シリアル No.プロパティの各値を画面に表示します。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[4] 上 記 の 「 想 定 UI 画 面 」 の 「 実 行 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIRestoreCancelStatus メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 296 -APIRestoreRegisterStatus メソッド
【機能】
「認証登録状態回復」を実行します。
【構文】<VB.NET>
Public Function APIRestoreRegisterStatus() As Boolean<C#>public bool APIRestoreRegisterStatus()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容

※

UI
UI
UI
UI
UI
UI
UI

APIProductID
APISerialNo
APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName
APIProxyServerPassword

Code

APIDisabledNICIgnore

Code
Code
Code
Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

Code
Code
Code
Code

APIWebServiceBasicAuthenticationPassword
APIWebServiceBasicAuthenticationUserName
APIWebServiceCheckPassword
APIWebServiceTimeout（認証登録する）プロダクト ID（認証登録する）シリアル No.
プロキシサーバーの使用区分
プロキシサーバーのアドレス
プロキ
シサー
プロキシサーバーのポート
プロキシサーバーのユーザ名 バ ー 使
プロキシサーバーのパスワー 用 時 有
効ド
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
猶予（試用）日数CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジストリキーパス
Web サービス時の基本認証パスワード
Web サービス時の基本認証ユーザ名
Web サービス確認パスワード
Web サービスのタイムアウト「認証レスキュー！.NET」 ユーザーズガイド- 297 -

Code
Code

APIWebServiceURL
APIWebServiceUseBasicAuthentication

Web サービスの URL
Web サービス時の基本認証の使用区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「認証登録状態回復」を実行します。
「ライセンス認証登録」でデータベースの登録に成功したが、エンドユーザ PC での認証登録が失敗した状態になった場合に、このメソッドによる処理でエンドユーザの操作でその状態を回復しエンド
ユーザ PC を認証登録状態とします。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

◆処理手順
一連の処理の手順は次の通りです。
[1]プロダクト ID とシリアル No.をエンドユーザに画面より入力させ、プロダクト ID プロパティ（APIProductID プロパティ）とシリアル No. プロパティ（APISerialNo プロパティ）にそれぞれ設定します。あるいは、別の方法で結果としてプロダクト ID プロパティ（APIProductID プロパティ）とシリ
アル No. プロパティ（APISerialNo プロパティ）にそれぞれ認証登録するプロダクト ID とシリアル No.
を設定します。
[2]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[3] 上 記 の 「 想 定 UI 画 面 」 の 「 登 録 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIRestoreRegisterStatus メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 298 -APIRunNR2AppDateRemove メソッド
【機能】
「アプリ起動日」を削除します。
【構文】<VB.NET>
Public Function APIRunNR2AppDateRemove() As Boolean<C#>public bool APIRunNR2AppDateRemove()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※Code

APIVendorsProductStartRegistryKeyPath

ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「アプリ起動日」を削除します。
認証レスキュー！を含む貴社のアプリを起動した際に、レジストリに記録されている前回の「アプリ起動日」を確認します。
（もし、「アプリ起動日」が存在しなかった場合は、起動した際にレジストリに記録します。）
その「アプリ起動日」より PC の日付が古い場合、故意に PC の日付が変更されたということで「PCの日付が変更されました。（APIErrorStatus=174）」というメッセージが表示されます。
例：
たとえば、本日を 6 月 1 日とします。PC の日付を 6 月 2 日に設定しアプリを起動します。
次に、PC の日付を本日（つまり 6 月 1 日）に戻しても、「アプリ起動日」は 6 月 2 日で記録されており、PC の日付が古いので「PC の日付が変更されました。」というメッセージが表示されます。
この状態になった場合、PC の日付を 6 月 2 日に設定しない限り、認証登録等が実行できません。
このメソッドを実行後は、再度 PC の日付を本日（つまり 6 月 1 日）に設定して、アプリをご利用いただける状態にします。

「認証レスキュー！.NET」 ユーザーズガイド- 299 -APIRunNR2AppDateRemove2 メソッド
【機能】
「アプリ起動日」を削除します。
【構文】<VB.NET>
Public Function APIRunNR2AppDateRemove2() As Boolean<C#>public bool APIRunNR2AppDateRemove2()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※Code

APISelectRunAppDatePathFlag

Code

APIVendorsProductStartRegistryKeyPath「アプリ起動日」の読み込み/書き込み場
所の切り替えフラグ
ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
以下の機能以外は従来の APIRunNR2AppDateRemove メソッドと同等です。
APISelectRunAppDatePathFlag プロパティ値による場所+従来のAPIVendorsProductStartRegistryKeyPath プロパティ値の場所の「アプリ起動日」を削除します。
このメソッドは、ユーザ様からのご要望で追加いたしました。
APIActivateStatusCheck2 メソッドで書き込まれた「アプリ起動日」を削除します。

「認証レスキュー！.NET」 ユーザーズガイド- 300 -

APITrialStartDateRemove メソッド
【機能】
「猶予日数」の「開始日」を削除します。
【構文】<VB.NET>
Public Function APITrialStartDateRemove() As Boolean<C#>public bool APITrialStartDateRemove()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容※Code

APIVendorsProductStartRegistryKeyPath

ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「猶予日数」の「開始日」を削除します。
このメソッドを実行後は、エンドユーザは再度「猶予日数」分の利用が可能になります。

「認証レスキュー！.NET」 ユーザーズガイド- 301 -

APIUpdateOfExpirationDate メソッド
【機能】
「有効期限の更新」を実行します。
【構文】<VB.NET>
Public Function APIUpdateOfExpirationDate() As Boolean<C#>public bool APIUpdateOfExpirationDate()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

機能

※

UI

APIProductID

UI

APISerialNo

UI

APICurrentExpirationDate

UI

APIUseProxyServer（有効期限を更新する）プロダクト ID（レジストリからの）認証登録済み情報 の 取 得 メ ソ ッ ド（APIGetRegisteredInfoFromRegistryメソッド）の実行により、登録済みのプロダクト ID が当プロパティに設定されます。
（有効期限を更新する）シリアル No.
（レジストリからの）認証登録済み情報 の 取 得 メ ソ ッ ド（APIGetRegisteredInfoFromRegistryメソッド）の実行により、登録済みのシリアル No.が当プロパティに設定されます。
（有効期限を更新する）現在の有効期限（レジストリからの）認証登録済み情報 の 取 得 メ ソ ッ ド（APIGetRegisteredInfoFromRegistryメソッド）の実行により、登録済みの
現在の有効期限が当プロパティに設定されます。
プロキシサーバーの使用区分「認証レスキュー！.NET」 ユーザーズガイド- 302 -UI

APIProxyServerAddress

UI

APIProxyServerPort

UI

APIProxyServerUserName

UI

APIProxyServerPassword

Code

APIDisabledNICIgnore

Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APIOverwriteModeOfExpirationDateUpdate

Code
Code
Code
Code

APITrialPeriod
APIUseCpuInfo
APIUseMacAddress
APIVendorsProductStartRegistryKeyPath

Code

APIWebServiceBasicAuthenticationPassword

Code

APIWebServiceBasicAuthenticationUserName

Code
Code
Code
Code

APIWebServiceCheckPassword
APIWebServiceTimeout
APIWebServiceURL
APIWebServiceUseBasicAuthentication

プロキシサーバーの プ ロ キ シ サ
アドレス
ーバー使用
プロキシサーバーの 時有効
ポート
プロキシサーバーの
ユーザ名
プロキシサーバーのパスワード処理を高速化するため、無効になっている NIC（Network Interface Card）
を無視します。
暗号化時のパスワード
暗号化時の Salt 文字列
新しい有効期限が現在と同じか古い場合の対応を設定します。
True：新しい有効期限が現在と同じか古い場合でも更新します。
False：新しい有効期限が現在と同じか古い場合は更新しません。
猶予（試用）日数CPU 情報の使用区分
MAC アドレスの使用区分
ベンダアプリケーション開始レジスト
リキーパス
Web サービス時の基本認証パスワード
Web サービス時の基本認証ユーザ
名
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用
区分※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】「有効期限の更新」を実行します。
プロダクト ID とシリアル No.が有効期限によるライセンスの場合、当メソッドによる処理を利用してエンドユーザに有効期限を更新させることができます。
この処理をエンドユーザに実行してもらう前に、貴社で新しい有効期限の設定をする必要があります。
有効期限の設定は認証管理システムの「認証キー編集（表形式）」処理を利用します。
◆想定 UI 画面
当メソッドの利用時に、想定する貴社作成の UI（ユーザインターフェース）画面は次の通りです。

「認証レスキュー！.NET」 ユーザーズガイド- 303 -

この画面上の「認証 ID」、「プロダクト ID」、「シリアル No.」は、（レジストリからの）認証登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）の実行で設定される認証 ID プロパティ（APICertificationID プロパティ）、プロダクト ID プロパティ（APIProductID プロパティ）、シリアル No.
プロパティ（APISerialNo プロパティ）でそれぞれ取得できます。
この画面上の「 現在の有効期限 」は、（レジストリ からの）認証登録済み情報の 取得メソッ ド（APIGetRegisteredInfoFromRegistry メソッド）の実行で設定される現在の有効期限プロパティ（APICurrentExpirationDate プロパティ）で取得できます。
◆処理手順
一連の処理の手順は次の通りです。
[1]（レジストリからの）認証登録済み情報の取得メソッド（APIGetRegisteredInfoFromRegistry メソッド）
を実行します。
これにより、プロダクト ID プロパティ、シリアル No.プロパティ、現在の有効期限プロパティに各値が設定されます。
[2]プロダクト ID プロパティ、シリアル No.プロパティ、現在の有効期限プロパティの各値を画面に表示します。
[3]上記の【必須設定プロパティ】一覧にある「設定区分」が「Code」のプロパティに適切な値を設定します。
★これらのプロパティは、一度設定した内容で変更がなければ再設定する必要はありません。

[4] 上 記 の 「 想 定 UI 画 面 」 の 「 更 新 」 ボ タ ン に 連 動 さ せ る な ど し て 、 当 メ ソ ッ ド（APIUpdateOfExpirationDate メソッド）を実行します。
［5］上記の「想定 UI 画面」の「新しい有効期限」に更新後の有効期限を表示します。更新後の有効
期限は、処理手順の［1］を再度行うことで取得できます。
なお、エンドユーザに有効期限を更新させる方法として当処理を実行させる他に、エンドユーザに一度認証の解除後、再度認証の登録をしてもらうことでも更新が完了します。
エンドユーザが代理認証を利用している場合で、有効期限によるライセンスを更新する場合はその方法を使います。

「認証レスキュー！.NET」 ユーザーズガイド- 304 -

APIWriteProxyServerInfoToRegistry メソッド
【機能】
レジストリへプロキシサーバーの情報を書き込みます。
【構文】<VB.NET>
Public Function APIWriteProxyServerInfoToRegistry() As Boolean<C#>public bool APIWriteProxyServerInfoToRegistry()

【引数】
なし
【戻り値】
True：
正常
False： エラー（未設定や範囲を超えているプロパティがある）
戻り値とは別に、APIErrorStatus プロパティに当メソッド実行後のエラー内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
設定
区分

プロパティ

設定する内容

※

UI
UI
UI
UI

APIUseProxyServer
APIProxyServerAddress
APIProxyServerPort
APIProxyServerUserName

UI

APIProxyServerPassword

Code
Code
Code

APIEncryptionPassword
APIEncryptionSaltString
APIVendorsProductStartRegistryKeyPath

プロキシサーバーの使用区分
プロキシサーバーのアドレス プ ロ キ シ
サーバー
プロキシサーバーのポート
プロキシサーバーのユーザ 使用時
名
プロキシサーバーのパスワ
ード
暗号化時のパスワード
暗号化時の Salt 文字列
ベンダアプリケーション開始レジストリキ
ーパス※設定区分：UI⇒主に「想定 UI 画面」から設定されるプロパティ/Code⇒主にプログラム（コード）で設定されるプロパティ【解説】
レジストリへプロキシサーバーの情報を書き込みます。
[1]このメソッドの戻り値は成功か失敗（True/False）。
[2]プロキシサーバーのユーザ名とパスワードを暗号化しており暗号化が失敗すると、当メソッドは失敗します。また、レジストリの書き込みで何らかの原因で失敗すると、当メソッドは失敗します。

「認証レスキュー！.NET」 ユーザーズガイド- 305 -

<ASP.NET 系プロパティ>
プロパティ一覧
プロパティ
APIxError 列挙体
APIxDisabledNICIgnore

機能
エラー内容を表します。
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
APIxErrorStatus
ASP.NET 系のメソッドを使用した際のエラーの内容を返す。（取得専用）
APIxExpirationDate
有効期限を設定します。
APIxExternalLinkKey
外部データベースとの「リンク用キー」を設定します。
APIxFreeItem1～5
自由入力項目 1～5 を設定します。
APIxKindOfRandom
シリアル No.をランダムに自動作成する場合の文字種別を設定します。
APIxLicenseCount
ライセンス数を設定します。
APIxNumberingCount
シリアル No.を作成する数を設定します。
APIxProductID
プロダクト ID を設定します。
APIxProxyServerAddress
プロキシサーバーのアドレスを設定します。
APIxProxyServerPassword
プロキシサーバーのパスワードを設定します。
APIxProxyServerPort
プロキシサーバーのポートを設定します。
APIxProxyServerUserName
プロキシサーバーのユーザ名を設定します。
APIxSerialNo
シリアル No.を設定・取得します。
APIxSerialNoString
認証キー情報作成直後のシリアル No.を取得します。（取得専用）
APIxStartNo
シリアル No.を自動的にナンバリングして作成する
場合の開始番号を設定します。
APIxStartFixedString
作成するシリアル No.の上位固定文字列を設定します。
APIxStepNo
シリアル No.を自動的にナンバリングして作成する
場合の間隔（ステップ）数を設定します。
APIxUseFloatingLicense
フローティングライセンスの使用区分（デフォルト：
False）を設定します。
APIxUseProxyServer
プロキシサーバーの使用区分（デフォルト：False）
を設定します。
APIxUseExpirationDate
有効期限利用の有無（False：利用しない、True：
利用する）を設定します。
APIxWebServiceBasicAuthenticationPassword Web サービス時の基本認証パスワードを設定します。
APIxWebServiceBasicAuthenticationUserName Web サービス時の基本認証ユーザ名を設定します。
APIxWebServiceCheckPassword
Web サービス確認パスワード(8 文字以上)を設定します。
APIxWebServiceTimeout
Web サービスのタイムアウト（デフォルト：60 秒）を設定します。
APIxWebServiceURL
Web サービスの URL を設定します。
APIxWebServiceUseBasicAuthentication
Web サービス時の基本認証の使用（デフォルト：
False）を設定します。

「認証レスキュー！.NET」 ユーザーズガイド- 306 -

APIxError 列挙体
エラー内容を表します。
public enum APIxError
パブリックメンバ
メンバ名
None
OutOfMemoryException

値
011

StackOverflowException

12

UnauthorizedAccessExce
ption

13

IoDirectoryNotFoundExce
ption
IoDriveNotFoundException14

IoEndOfStreamException

16

IoFileLoadException

17

IoFileNotFoundException

18

IoIOException

19

IoPathTooLongException

20

BadStrInProductID

101

BadStrInSerialNo

102

15

内容

関連するメソッド

エラーなし
プログラムの実行を継続するためのメ
モリが不足している場合にスローされる例外。
入れ子になったメソッド呼び出しが多くなりすぎ、実行スタックがオーバーフロ
ーした場合にスローされる例
外。 このクラスは継承できません。
オペレーティング システムが I/O エラーまたは特定の種類のセキュリティ
エラーのためにアクセスを拒否す
る場合、スローされる例外。
ファイルまたはディレクトリの一部が見つからない場合にスローされる例外。
使用できないドライブまたは共有にアクセスしようとするとスローされる例
外。
ストリームの末尾を越えて読み取ろうとしたときにスローされる例外。
マネージ アセンブリが見つかったが、読み込むことができない場合にスローされる例外。
ディスク上に存在しないファイルにアクセスしようとして失敗したときにスローされる例外。
I/O エラーが発生したときにスローされる例外。
パス名またはファイル名がシステム定義の最大長を超えている場合にスローされる例外。
プロダクト ID に不正な文字が含まれて APIxCreateNumb
います。
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDateシリアル No.に不正な文字が含まれて APIxCreateOneA
います。
ctivationKey
APIxDeleteActiva「認証レスキュー！.NET」 ユーザーズガイド- 307 -

FailedEnableNIC

104

FailedDisableNIC

105

NoMACAdress

106

AlreadyRegistered111

BadCheckPassword

112

tionKey
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDate
NIC の設定に失敗しました。（無効化） APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDate
MAC アドレスが 1 つも取得できません APIxCreateNumb
でした。
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDate既に登録済みのプロダクト ID とシリア APIxCreateNumb
ル№の組み合わせがあったため登録 eringActivationKeを中止しました。
y
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
確認パスワードが不正です。
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
NIC の設定に失敗しました。（有効化）「認証レスキュー！.NET」 ユーザーズガイド- 308 -

BadWaiFile

113

WebServEnv.wai ファイルに問題があります。
認証 Web サービス実行 PC 上で「認証レ ス キ ュ ー ！ .NET Web 環 境 設 定 」（WebAdmin.exe）が行われていない可能性があります。

ExpirationDateIsOutOfRan
ge116

有効期限が不正です。

ExpirationDateIsOldDate

117

入力された「有効期限」が無効（前日以前）です。

ProductIDIsEmpty

156

プロダクトIDが入力されていません。

SerialNoIsEmpty

157

シリアル№が入力されていません。

APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxCreateRando
mActivationKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxCreateRando
mActivationKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxEditOfExpirat
ionDateAPIxCreateOneA
ctivationKey
APIxEditOfExpirat
ionDate「認証レスキュー！.NET」 ユーザーズガイド- 309 -

CanNotUseTheString164

使用できない文字列が含まれています。

PropertyValueNotFound

165「必須設定プロパティ」に値が設定されていません。

DataBaseNotFound170

データベースが存在しません。
データベースは「Webインストーラ」を起動し「データベースのインストール」を実行すると作成されます。

CanNotConnectToTheSer
ver

171

何らかの理由でサーバーに接続できませんでした。

DataTableNotFound

172

データテーブルが存在しません。
Web 環境設定で「データテーブル新規作成」の処理を行ってから、再度、この処理を行ってください。

APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando「認証レスキュー！.NET」 ユーザーズガイド- 310 -

BadStrInFixedSerialNo

173

シリアルNo.の上位固定文字列に不正な文字が含まれています。

InvalidStartNo

174

開始番号は0～99999の範囲で設定してください。

InvalidStepNo

175

ステップ数は1～99999の範囲で設定してください。

InvalidNumberingNo

176

ナンバリング数は1～1000の範囲で設定してください。

InvalidLicenseNo

177

ライセンス数は1～100の範囲で設定してください。

欠番
SerialNoDigitsTooMany

178
179

旧レンタル機能関連
上位固定文字列と番号の桁数を合わせると指定したシリアル No.の桁数より多すぎます。

CanNotEnterBlanksInThe
ProductID

182

プロダクトIDには空白は入力できません。

ProductIDDigitsNotEnough183

入力されたプロダクト ID の桁数が足りません。

mActivationKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateRando
mActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateRando
mActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateRando
mActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey「認証レスキュー！.NET」 ユーザーズガイド- 311 -

AnErrorOccurred

184

ProductIDAndSerialNoNot
Found

185

SerialNoDigitsNotEnough

186

CanNotEnterBlanksInThe
SerialNo

187

BadStrInExternalLinkKey

188

BadStrInFreeItem1

189

BadStrInFreeItem2

190

BadStrInFreeItem3

191

APIxEditOfExpirat
ionDate
何らかのエラーが発生しました。
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxDeleteActiva
tionKey
APIxDeleteActiva
tionKey
APIxEditOfExpirat
ionDateそのプロダクトIDとシリアル№の組み
APIxDeleteActiva
合わせは登録されていません。
tionKey
APIxEditOfExpirat
ionDate
入力されたシリアル No.の桁数が足り
APIxCreateOneAません。
ctivationKey
APIxEditOfExpirat
ionDateシリアル No.には空白は入力できませ APIxCreateOneAん。
ctivationKey
APIxEditOfExpirat
ionDate
リンク用キーに不正な文字が含まれて APIxCreateNumb
います。
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
自由入力項目 1 に不正な文字が含ま APIxCreateNumb
れています。
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
自由入力項目 2 に不正な文字が含ま APIxCreateNumb
れています。
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
自由入力項目 3 に不正な文字が含ま APIxCreateNumb
れています。
eringActivationKe「認証レスキュー！.NET」 ユーザーズガイド- 312 -

BadStrInFreeItem4192

BadStrInFreeItem5

193

BadKindOfRandomOfSerialNo
BadExpirationDate

194

ProductIDIsTooLong

196

SerialNoIsTooLong

197

BadFormatExpirationDate

198

195

y
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
自由入力項目 4 に不正な文字が含ま APIxCreateNumb
れています。
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
自由入力項目 5 に不正な文字が含ま APIxCreateNumb
れています。
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
シリアルNo.をランダムに自動作成する APIxCreateRando
ための文字種別が不正です。
mActivationKey
有効期限が不正です。
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxEditOfExpirat
ionDate
入力されたプロダクト ID の桁数が多い APIxCreateNumb
です。
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxEditOfExpirat
ionDate
入力されたシリアル No.の桁数が多い APIxCreateOneAです。
ctivationKey
APIxEditOfExpirat
ionDate
有効期限の書式が不正です。
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey「認証レスキュー！.NET」 ユーザーズガイド- 313 -

ExternalLinkKeyIsTooLong

199

入力されたリンク用キーの桁数が多いです。

APIxFreeItem1IsTooLong

200

入力された自由入力項目 1 の桁数が多いです。

APIxFreeItem2IsTooLong201

入力された自由入力項目 2 の桁数が多いです。

APIxFreeItem3IsTooLong202

入力された自由入力項目 3 の桁数が多いです。

APIxFreeItem4IsTooLong

203

入力された自由入力項目 4 の桁数が多いです。

APIxFreeItem5IsTooLong

204

入力された自由入力項目 5 の桁数が多いです。

APIxEditOfExpirat
ionDateAPIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey
APIxCreateNumb
eringActivationKey
APIxCreateOneA
ctivationKey
APIxCreateRando
mActivationKey「認証レスキュー！.NET」 ユーザーズガイド- 314 -

APIxDisabledNICIgnore プロパティ【機能】
処理を高速化するため、無効になっている NIC（Network Interface Card）を無視します。
デフォルト：True。
【構文】<VB.NET>
Public Property APIxDisabledNICIgnore As Boolean<C#>public bool APIxDisabledNICIgnore { set; get; }【解説】
認証レスキュー！の認証 UI ライブラリでは、各処理時に PC の MAC アドレスを最大で 5 個記録します。MAC アドレスは LAN ポートなどのネットワーク機器に固有な物理アドレスです。
このプロパティが False の場合、無効になっている NIC を一度有効にし、情報を取得後に再度 NICを無効にします。この際に少し時間が掛かります。
このプロパティを True に設定すると、この無効の NIC は無視し、有効の NIC のみ情報を取得して記録します。これにより、情報の取得が高速化します。

「認証レスキュー！.NET」 ユーザーズガイド- 315 -

APIxErrorStatus プロパティ【機能】
ASP.NET 系のメソッドを使用した際のエラーの内容を返します。
【構文】<VB.NET>
Public ReadOnly Property APIxErrorStatus As Integer<C#>public int APIxErrorStatus { get; }【解説】
ASP.NET 系 の メ ソ ッ ド は 戻 り 値 と し て 正 常 （ True ） か エ ラ ー （ False ） を 返 し ま す が 、 こ のAPIxErrorStatus プロパティはそのエラーの内容を APIxError 列挙体の参照で返します。このAPIxErrorStatus プロパティは取得専用です。

「認証レスキュー！.NET」 ユーザーズガイド- 316 -

APIxExpirationDate プロパティ【機能】
有効期限を設定します。
【構文】<VB.NET>
Public Property APIxExpirationDate As String<C#>public string APIxExpirationDate { set; get; }【解説】
有効期限を設定します。
有効期限は、"ｙｙｙｙ/mm/dd"形式で設定してください。
（例）西暦 2020 年 10 月 1 日を設定する場合<VB> Class1.myAPIActivate.APIxExpirationDate = "2020/10/01"<C#> Class1.myAPIActivate.APIxExpirationDate = "2020/10/01";
次のメソッドの実行時に当プロパティ（APIxExpirationDate プロパティ）に有効期限を設定します。
・APIxCreateOneActivationKey メソッド
・APIxCreateRandomActivationKey メソッド
・APIxCreateNumberingActivationKey メソッド
・APIxEditOfExpirationDate メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 317 -

APIxExternalLinkKey プロパティ【機能】
外部データベースとの「リンク用キー」を設定します。
【構文】<VB.NET>
Public Property APIxExternalLinkKey As String<C#>public string APIxExternalLinkKey { set; get; }【解説】
外部データベースとの「リンク用キー」を設定します。
「リンク用キー」の設定は任意で、認証レスキュー！の運用時の必須設定項目ではありません。
この項目は最大 64 バイトです。
次の認証キー情報を作成するメソッドの実行時に当プロパティ（APIxExternalLinkKey プロパティ）に設定された値が、認証レスキュー！のデータベースの認証キーテーブルの「リンク用キー」に格納されます。
・APIxCreateOneActivationKey メソッド
・APIxCreateRandomActivationKey メソッド
・APIxCreateNumberingActivationKey メソッド
この内、APIxCreateRandomActivationKey メソッドと APIxCreateNumberingActivationKey メソッドは複数の認証キー（レコード）を作成できますが、すべての認証キー（レコード）に当プロパティ（APIxExternalLinkKey プロパティ）に設定された値が、作成するすべての認証キー（レコード）の「リンク用キー」に格納されます。

「認証レスキュー！.NET」 ユーザーズガイド- 318 -

APIxFreeItem1～5 プロパティ【機能】
自由入力項目 1～5 を設定します。
【構文】<VB.NET>
Public Property APIxFreeItem1 As String
Public Property APIxFreeItem2 As String
Public Property APIxFreeItem3 As String
Public Property APIxFreeItem4 As String
Public Property APIxFreeItem5 As String<C#>public string APIxFreeItem1 { set; get; }public string APIxFreeItem2 { set; get; }public string APIxFreeItem3 { set; get; }public string APIxFreeItem4 { set; get; }public string APIxFreeItem5 { set; get; }【解説】
自由入力項目 1～5 を設定します。
「自由入力項目」の設定は任意で、認証レスキュー！の運用時の必須設定項目ではありません。
この項目は最大 128 バイトです。
次の認証キー情報を作成するメソッドの実行時に当プロパティ（APIxFreeItem1～5 プロパティ）に設定された値が、認証レスキュー！のデータベースの認証キーテーブルの「自由入力項目 1～5」に格納されます。
・APIxCreateOneActivationKey メソッド
・APIxCreateRandomActivationKey メソッド
・APIxCreateNumberingActivationKey メソッド
この内、APIxCreateRandomActivationKey メソッドと APIxCreateNumberingActivationKey メソッドは
認証キーテーブルの認証キー（レコード）を同時に複数作成できますが、当プロパティ（APIxFreeItem1～5 プロパティ）に設定された値が、作成するすべての認証キー（レコード）の「自由入力項目 1～5」に格納されます。

「認証レスキュー！.NET」 ユーザーズガイド- 319 -

APIxKindOfRandom プロパティ【機能】
シリアル No.をランダムに自動作成する場合の文字種別を設定します。
【構文】<VB.NET>
Public Property APIxKindOfRandom As Integer<C#>public int APIxKindOfRandom { set; get; }【解説】
シリアル No.をランダムに自動作成する場合の文字種別を設定します。
当プロパティ（APIxKindOfRandom プロパティ）に設定する値は次の通りです。
0：数字のみ1：数字と英字（大文字）2：数字と英字（小文字）
3：数字と英字（大小文字）
次のメソッドの実行時に当プロパティ（APIxKindOfRandom プロパティ）を設定します。
・APIxCreateRandomActivationKey メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 320 -

APIxLicenseCount プロパティ【機能】ライセンス数を設定します。
【構文】<VB.NET>
Public Property APIxLicenseCount As Integer<C#>public int APIxLicenseCount { set; get; }【解説】
ライセンス数を設定します。
次のメソッドの実行時に当プロパティ（APIxLicenseCount プロパティ）に（）内のライセンス数の各値を設定します。
・APIxCreateOneActivationKey メソッド（作成するライセンス数）
・APIxCreateRandomActivationKey メソッド（作成するライセンス数）
・APIxCreateNumberingActivationKey メソッド（作成するライセンス数）「認証レスキュー！.NET」 ユーザーズガイド- 321 -

APIxNumberingCount プロパティ【機能】
シリアル No.を作成する数を設定します。
【構文】<VB.NET>
Public Property APIxNumberingCount As Integer<C#>public int APIxNumberingCount { set; get; }【解説】
シリアル No.を作成する数を設定します。
次のメソッドの実行時に当プロパティ（APIxNumberingCount プロパティ）を設定します。
・APIxCreateRandomActivationKey メソッド
・APIxCreateNumberingActivationKey メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 322 -

APIxProductID プロパティ【機能】
プロダクト ID を設定します。
【構文】<VB.NET>
Public Property APIxProductID As String<C#>public string APIxProductID { set; get; }【解説】
プロダクト ID を設定します。
次のメソッドの実行時に当プロパティ（APIxProductID プロパティ）に（）内のプロダクト ID の各値を設定します。
・APIxCreateOneActivationKey メソッド（作成するプロダクト ID）
・APIxCreateRandomActivationKey メソッド（作成するプロダクト ID）
・APIxCreateNumberingActivationKey メソッド（作成するプロダクト ID）
・APIxDeleteActivationKey メソッド（削除するプロダクト ID）
・APIxEditOfExpirationDate メソッド（有効期限を変更したいプロダクト ID）「認証レスキュー！.NET」 ユーザーズガイド- 323 -

APIxProxyServerAddress プロパティ【機能】
プロキシサーバーのアドレスを設定します。
【構文】<VB.NET>
Public Property APIxProxyServerAddress As String<C#>public string APIxProxyServerAddress { set; get; }【解説】
プロキシサーバーのアドレスを設定します。
インターネットに接続する際にプロキシサーバーを使用する場合のみ設定が必要です。
プロキシサーバーを使用する場合は、当プロパティを含む次のプロパティに適切な設定が必要です。
・APIxProxyServerAddress プロパティ（プロキシサーバーのアドレス）→当プロパティ
・APIxProxyServerPort プロパティ（プロキシサーバーのポート）・APIxProxyServerUserName プロパティ（プロキシサーバーのユーザ名）
・APIxProxyServerPassword プロパティ（プロキシサーバーのパスワード）
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIxCreateOneActivationKey メソッド（製品 1 本分の認証キーの新規作成）
・APIxCreateRandomActivationKey メソッド（認証キーのシリアル No.をランダムに自動作成）
・APIxCreateNumberingActivationKey メソッド（認証キーのシリアル No.を自動ナンバリング作成）
・APIxDeleteActivationKey メソッド（作成済みの認証キーの削除）
・APIxEditOfExpirationDate メソッド（既存の有効期限を変更））「認証レスキュー！.NET」 ユーザーズガイド- 324 -

APIxProxyServerPassword プロパティ【機能】
プロキシサーバーのパスワードを設定します。
【構文】<VB.NET>
Public Property APIxProxyServerPassword As String<C#>public string APIxProxyServerPassword { set; get; }【解説】
プロキシサーバーのパスワードを設定します。
インターネットに接続する際にプロキシサーバーを使用する場合のみ設定が必要です。
プロキシサーバーを使用する場合は、当プロパティを含む次のプロパティに適切な設定が必要です。
・APIxProxyServerAddress プロパティ（プロキシサーバーのアドレス）
・APIxProxyServerPort プロパティ（プロキシサーバーのポート）・APIxProxyServerUserName プロパティ（プロキシサーバーのユーザ名）
・APIxProxyServerPassword プロパティ（プロキシサーバーのパスワード）→当プロパティ
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIxCreateOneActivationKey メソッド（製品 1 本分の認証キーの新規作成）
・APIxCreateRandomActivationKey メソッド（認証キーのシリアル No.をランダムに自動作成）
・APIxCreateNumberingActivationKey メソッド（認証キーのシリアル No.を自動ナンバリング作成）
・APIxDeleteActivationKey メソッド（作成済みの認証キーの削除）
・APIxEditOfExpirationDate メソッド（既存の有効期限を変更））「認証レスキュー！.NET」 ユーザーズガイド- 325 -

APIxProxyServerPort プロパティ【機能】
プロキシサーバーのポートを設定します。
【構文】<VB.NET>
Public Property APIxProxyServerPort As String<C#>public string APIxProxyServerPort { set; get; }【解説】
プロキシサーバーのポートを設定します。
インターネットに接続する際にプロキシサーバーを使用する場合のみ設定が必要です。
プロキシサーバーを使用する場合は、当プロパティを含む次のプロパティに適切な設定が必要です。
・APIxProxyServerAddress プロパティ（プロキシサーバーのアドレス）
・APIxProxyServerPort プロパティ（プロキシサーバーのポート）→当プロパティ
・APIxProxyServerUserName プロパティ（プロキシサーバーのユーザ名）
・APIxProxyServerPassword プロパティ（プロキシサーバーのパスワード）
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIxCreateOneActivationKey メソッド（製品 1 本分の認証キーの新規作成）
・APIxCreateRandomActivationKey メソッド（認証キーのシリアル No.をランダムに自動作成）
・APIxCreateNumberingActivationKey メソッド（認証キーのシリアル No.を自動ナンバリング作成）
・APIxDeleteActivationKey メソッド（作成済みの認証キーの削除）
・APIxEditOfExpirationDate メソッド（既存の有効期限を変更））「認証レスキュー！.NET」 ユーザーズガイド- 326 -

APIxProxyServerUserName プロパティ【機能】
プロキシサーバーのユーザ名を設定します。
【構文】<VB.NET>
Public Property APIxProxyServerUserName As String<C#>public string APIxProxyServerUserName { set; get; }【解説】
プロキシサーバーのユーザ名を設定します。
インターネットに接続する際にプロキシサーバーを使用する場合のみ設定が必要です。
プロキシサーバーを使用する場合は、当プロパティを含む次のプロパティに適切な設定が必要です。
・APIxProxyServerAddress プロパティ（プロキシサーバーのアドレス）
・APIxProxyServerPort プロパティ（プロキシサーバーのポート）・APIxProxyServerUserName プロパティ（プロキシサーバーのユーザ名）→当プロパティ
・APIxProxyServerPassword プロパティ（プロキシサーバーのパスワード）
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIxCreateOneActivationKey メソッド（製品 1 本分の認証キーの新規作成）
・APIxCreateRandomActivationKey メソッド（認証キーのシリアル No.をランダムに自動作成）
・APIxCreateNumberingActivationKey メソッド（認証キーのシリアル No.を自動ナンバリング作成）
・APIxDeleteActivationKey メソッド（作成済みの認証キーの削除）
・APIxEditOfExpirationDate メソッド（既存の有効期限を変更））「認証レスキュー！.NET」 ユーザーズガイド- 327 -

APIxSerialNo プロパティ【機能】
シリアル No.を設定します。
【構文】<VB.NET>
Public Property APIxSerialNo As String<C#>public string APIxSerialNo { set; get; }【解説】
シリアル No.を設定します。
次のメソッドの実行時に当プロパティ（APIxProductID プロパティ）に（）内のシリアル No.の各値を設定します。
・APIxCreateOneActivationKey メソッド（作成するシリアル No.）・APIxDeleteActivationKey メソッド（削除するシリアル No.）・APIxEditOfExpirationDate メソッド（有効期限を変更したいシリアル No.）

「認証レスキュー！.NET」 ユーザーズガイド- 328 -

APIxSerialNoString プロパティ【機能】
認証キー情報作成直後のシリアル No.を取得します。（取得専用）【構文】<VB.NET>
Public Property APIxSerialNoString As String<C#>public string APIxSerialNoString { get; }【解説】
認証キー情報作成直後のシリアル No.を取得します。（取得専用）
認証キー情報とは、プロダクト ID、シリアル No.、ライセンス数、有効期限利用の有無、有効期限などの総称です。
次のメソッドを実行すると当プロパティ（APIxSerialNoString プロパティ）に新しく生成されたシリアル
No の文字列が設定されます。
・APIxCreateOneActivationKey メソッド
・APIxCreateNumberingActivationKey メソッド
・APIxCreateRandomActivationKey メソッド
複数のシリアル No.が生成された場合は、デリミタのカンマ（，）で区切られた文字列が設定されます。
（例）"00000001,00000002,00000003"
上記メソッド実行時のエラーによるシリアル No.の未生成時は、当プロパティ（APIxSerialNo プロパティ）には、""（空文字列）が設定されます。

「認証レスキュー！.NET」 ユーザーズガイド- 329 -

APIxStartNo プロパティ【機能】
シリアル No.を自動的にナンバリングして作成する場合の開始番号を設定します。
【構文】<VB.NET>
Public Property APIxStartNo As Integer<C#>public int APIxStartNo { set; get; }【解説】
シリアル No.を自動的にナンバリングして作成する場合の開始番号を設定します。
次のメソッドの実行時に当プロパティ（APIxStartNo プロパティ）を設定します。
・APIxCreateNumberingActivationKey メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 330 -

APIxStartFixedString プロパティ【機能】
作成するシリアル No.の上位固定文字列を設定します。
【構文】<VB.NET>
Public Property APIxStartFixedString As String<C#>public string APIxStartFixedString { set; get; }【解説】作成するシリアル No.の上位固定文字列を設定します。
（例）作成するシリアル No.の上位 4 桁を"0001"で固定する場合<VB> Class1.myAPIActivate.APIxStartFixedString = "0001"<C#> Class1.myAPIActivate.APIxStartFixedString = "0001";
次のメソッドの実行時に当プロパティ（APIxStartFixedString プロパティ）に上位固定文字列を設定します。
・APIxCreateRandomActivationKey メソッド
・APIxCreateNumberingActivationKey メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 331 -

APIxStepNo プロパティ【機能】
シリアル No.を自動的にナンバリングして作成する場合の間隔（ステップ）数を設定します。
【構文】<VB.NET>
Public Property APIxStepNo As Integer<C#>public int APIxStepNo { set; get; }【解説】
シリアル No.を自動的にナンバリングして作成する場合の間隔（ステップ）数を設定します。
次のメソッドの実行時に当プロパティ（APIxStepNo プロパティ）を設定します。
・APIxCreateNumberingActivationKey メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 332 -

APIxUseFloatingLicense プロパティ【機能】
フローティングライセンス使用区分（デフォルト：False）を設定します。
【構文】<VB.NET>
Public Property APIxUseFloatingLicense As Boolean<C#>public bool APIxUseFloatingLicense { set; get; }【解説】フローティングライセンス使用区分（デフォルト：False）を設定します。

「認証レスキュー！.NET」 ユーザーズガイド- 333 -

APIxUseProxyServer プロパティ【機能】
プロキシサーバーの使用区分（デフォルト：False）を設定します。
【構文】<VB.NET>
Public Property APIxUseProxyServer As Boolean<C#>public bool APIxUseProxyServer { set; get; }【解説】
プロキシサーバーの使用区分（デフォルト：False）を設定します。
インターネットに接続する際にプロキシサーバーを使用するかどうかを設定します。
プロキシサーバーを使用する場合は当プロパティに True を、使用しない場合は False をそれぞれ設定します。
プロキシサーバーを使用する場合は、次のプロパティに適切な設定が必要です。
・APIxProxyServerAddress プロパティ（プロキシサーバーのアドレス）
・APIxProxyServerPort プロパティ（プロキシサーバーのポート）・APIxProxyServerUserName プロパティ（プロキシサーバーのユーザ名）
・APIxProxyServerPassword プロパティ（プロキシサーバーのパスワード）
プロキシサーバーを使用する場合、当プロパティの値を利用するメソッドは次の通りです。
・APIxCreateOneActivationKey メソッド（製品 1 本分の認証キーの新規作成）
・APIxCreateRandomActivationKey メソッド（認証キーのシリアル No.をランダムに自動作成）
・APIxCreateNumberingActivationKey メソッド（認証キーのシリアル No.を自動ナンバリング作成）
・APIxDeleteActivationKey メソッド（作成済みの認証キーの削除）
・APIxEditOfExpirationDate メソッド（既存の有効期限を変更））「認証レスキュー！.NET」 ユーザーズガイド- 334 -

APIxUseExpirationDate プロパティ【機能】
有効期限利用の有無（False：利用しない、True：利用する）を設定します。
【構文】<VB.NET>
Public Property APIxUseExpirationDate As Boolean<C#>public bool APIxUseExpirationDate { set; get; }【解説】
有効期限利用の有無（False：利用しない、True：利用する）を設定します。
次のメソッドの実行時に当プロパティ（APIxUseExpirationDate プロパティ）に有効期限利用の有無を設定します。
・APIxCreateOneActivationKey メソッド
・APIxCreateRandomActivationKey メソッド
・APIxCreateNumberingActivationKey メソッド
・APIxEditOfExpirationDate メソッド

「認証レスキュー！.NET」 ユーザーズガイド- 335 -

APIxWebServiceBasicAuthenticationPassword プロパティ【機能】
Web サービス時の基本認証パスワードを設定します。
【構文】<VB.NET>
Public Property APIxWebServiceBasicAuthenticationPassword As String<C#>public string APIxWebServiceBasicAuthenticationPassword { set; get; }【解説】
Web サーバーで基本認証を使用する場合に、そのパスワードを指定します。
基本認証に関しては、APIxWebServiceUseBasicAuthentication プロパティを参照してください。

「認証レスキュー！.NET」 ユーザーズガイド- 336 -

APIxWebServiceBasicAuthenticationUserName プロパティ【機能】
Web サービス時の基本認証ユーザ名を設定します。
【構文】<VB.NET>
Public Property APIxWebServiceBasicAuthenticationUserName As String<C#>public string APIxWebServiceBasicAuthenticationUserName { set; get; }【解説】
Web サーバーで基本認証を使用する場合に、そのユーザ名を指定します。
基本認証に関しては、APIxWebServiceUseBasicAuthentication プロパティを参照してください。

「認証レスキュー！.NET」 ユーザーズガイド- 337 -

APIxWebServiceCheckPassword プロパティ【機能】
Web サービス確認パスワード(8 文字以上)を設定します。
【構文】<VB.NET>
Public Property APIxWebServiceCheckPassword As String<C#>public string APIxWebServiceCheckPassword { set; get; }【解説】
Web サービスを利用する場合の確認用のパスワードを設定します。ここでは、Web サーバー側設定
アプリケーション「認証 Web サービス」の環境設定処理の Web サービスの確認パスワードと同じものを設定します。
確認パスワードは必須項目です、省略はできません。8 文字以上で半角の次の文字が使用できます。
・大文字の英字（A～Z）
・小文字の英字（a～ｚ）
・数字（0～9）・記号（+-*/!#$%&()=\@<>?）「認証レスキュー！.NET」 ユーザーズガイド- 338 -

APIxWebServiceTimeout プロパティ【機能】
Web サービスのタイムアウト（デフォルト：60 秒）を設定します。
【構文】<VB.NET>
Public Property APIxWebServiceTimeout As Integer<C#>public int APIxWebServiceTimeout { set; get; }【解説】
Web サービスに接続して応答を待つ最大時間を秒単位で指定します。初期値は 60 秒です。

「認証レスキュー！.NET」 ユーザーズガイド- 339 -

APIxWebServiceURL プロパティ【機能】
Web サービスの URL を設定します。
【構文】<VB.NET>
Public Property APIxWebServiceURL As String<C#>public string APIxWebServiceURL { set; get; }【解説】
認証に関するシステムを Web サービスとして提供する Web サーバーの URL を指定します。
以下に例を示します。
自 PC のローカルホストの Web サーバー（IIS）にアクセスする例："http://localhost/NRDWebService/Service.asmx"（注）この例は実際の運用ではありえません。貴社のアプリケーションで認証 UI ライブラリ（DLL）を使用した開発時に、テスト用に使用される URL です。
自社 Web サーバー（IIS）にアクセスさせる例："http://www.newtone.co.jp/NRDWebService/Service.asmx"
クラウドサービス Microsoft Azure の Web アプリ（App Service）に配置した Web サービスを利用する例："http://newtonecojp.azurewebsites.net/Service.asmx"「認証レスキュー！.NET」 ユーザーズガイド- 340 -

APIxWebServiceUseBasicAuthentication プロパティ【機能】
Web サービス時の基本認証の使用（デフォルト：False）を設定します。
【構文】<VB.NET>
Public Property APIxWebServiceUseBasicAuthentication As Boolean<C#>public bool APIxWebServiceUseBasicAuthentication { set; get; }【解説】
Web サーバーで基本認証を使用する場合は、当プロパティを True にします。
初期値は、False（基本認証を使用しない）です。
当プロパティは、Web サーバー（IIS）側で特定のアカウント（ユーザ名とパスワード）でアクセスできる
フォルダにこの Web サービスが配置してある場合に使用できるセキュリティ設定です。
Web サーバーで基本認証を使用する一般的な手順は次の通りです。
1.サーバーPC 上でユーザを作成。
この際のユーザ名とパスワードがそのまま基本認証に使われます。
2.基本認証フォルダのセキュリティ設定
フォルダのプロパティを開き、セキュリティタブで上記 1 のユーザ名を 追加し、「読み取り」権限を付与します。
3.IIS でのセキュリティ設定
IIS で該当フォルダに対し「認証」の設定で「匿名認証」を無効にして 「基本認証」を有効にします。
なお、Web サーバーでの基本認証の詳細につきましてはマイクロソフト社の関連ドキュメントをご覧ください。

「認証レスキュー！.NET」 ユーザーズガイド- 341 -

<ASP.NET 系メソッド>
メソッド一覧
メソッド
APIxCreateNumberingActivationKey
APIxCreateOneActivationKey
APIxCreateRandomActivationKey
APIxDeleteActivationKey
APIxEditOfExpirationDate

機能製品の認証キー情報を指定した数だけシリアル No.を自動的にナンバリングして作成します。
製品 1 本分の認証キー情報を新規に作成します。
製品の認証キー情報を指定した数だけ、シリアル No.
をランダムに自動作成します。
作成済みの認証キー情報を削除します。
既存の認証キー情報内の有効期限を変更します。

「認証レスキュー！.NET」 ユーザーズガイド- 342 -

APIxCreateNumberingActivationKey メソッド
【機能】
製品の認証キー情報を指定した数だけシリアル No.を自動的にナンバリングして作成します。
【構文】<VB.NET>
Public Function APIxCreateNumberingActivationKey () As Integer<C#>public int APIxCreateNumberingActivationKey ()

【引数】
なし
【戻り値】
生成されたシリアル No.の数。
エラー時は 0 が設定され、戻り値とは別に、APIxErrorStatus プロパティに当メソッド実行後のエラー
内容がセットされます。
また、APIxSerialNoString プロパティに新しく生成されたシリアル No.をデリミタのカンマ（，）で区切った文字列が設定されます。シリアル No.の未生成時は、""（空文字列）が設定されます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
プロパティ
APIxUseProxyServer
APIxProxyServerAddress
APIxProxyServerPort
APIxProxyServerUserName
APIxProxyServerPassword
APIxWebServiceBasicAuthenticationPassword
APIxWebServiceBasicAuthenticationUserName
APIxWebServiceCheckPassword
APIxWebServiceTimeout
APIxWebServiceURL
APIxWebServiceUseBasicAuthentication
APIxProductID
APIxLicenseCount
APIxUseExpirationDate
APIxExpirationDate
APIxStartFixedString機能
プロキシサーバーの使用区分
プロキシサーバーのアドレ プロキシサーバ
スー使用時
プロキシサーバーのポート
プロキシサーバーのユーザ名
プロキシサーバーのパスワ
ード
Web サービス時の基本認証パスワード（基本認証使用時）
Web サービス時の基本認証ユーザ名（基本認証使用時）
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分
プロダクト ID
ライセンス数有 効 期 限 利 用 の 有 無 （ False ： 利 用 し な い 、
True：利用する）
有効期限
作成するシリアル No.の上位固定文字列「認証レスキュー！.NET」 ユーザーズガイド- 343 -

APIxStartNo
APIxStepNo
APIxNumberingCount
APIxExternalLinkKey
APIxFreeItem1～5

作成するシリアル No.開始番号
作成するシリアル No.間隔（ステップ）数作成するシリアル No.の数
外部データベースとのリンク用キー項目を設定
自由入力項目 1～5 を設定【解説】
このメソッドは、認証キー情報を指定した数だけシリアル No.を自動的にナンバリングして作成します。
認証キー情報とは、プロダクト ID、シリアル No.、ライセンス数、有効期限利用の有無、有効期限などの総称です。
認証管理システム（InsideSystem.exe）の「認証キー作成（自動ナンバリング）」処理と同等の機能を提供します。
◆「認証キー作成（自動ナンバリング）」処理の画面例（参考）◆処理手順
一連の処理の手順は次の通りです。
[1]上記の【必須設定プロパティ】一覧にある各プロパティに適切な値を設定します。
[2]当メソッド（APIxCreateNumberingActivationKey メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 344 -

APIxCreateOneActivationKey メソッド【機能】
製品 1 本分の認証キー情報を新規に作成します。
【構文】<VB.NET>
Public Function APIxCreateOneActivationKey () As Integer<C#>public int APIxCreateOneActivationKey()

【引数】
なし
【戻り値】
生成されたシリアル No.の数（当メソッドの場合は 1）。
エラー時は 0 が設定され、戻り値とは別に、APIxErrorStatus プロパティに当メソッド実行後のエラー
内容がセットされます。
また、APIxSerialNoString プロパティには新しく生成されたシリアル No. （当メソッドの場合は、APIxSerialNo プロパティに指定した値）が設定されます。エラーによるシリアル No.の未生成時は、この APIxSerialNoString プロパティには、""（空文字列）が設定されます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
プロパティ
APIxUseProxyServer
APIxProxyServerAddress
APIxProxyServerPort
APIxProxyServerUserName
APIxProxyServerPassword
APIxWebServiceBasicAuthenticationPassword
APIxWebServiceBasicAuthenticationUserName
APIxWebServiceCheckPassword
APIxWebServiceTimeout
APIxWebServiceURL
APIxWebServiceUseBasicAuthentication
APIxProductID
APIxSerialNo
APIxLicenseCount
APIxUseExpirationDate
APIxExpirationDate

機能プロキシサーバーの使用区分
プロキシサーバーのアドレ プロキシサーバ
スー使用時
プロキシサーバーのポート
プロキシサーバーのユーザ名
プロキシサーバーのパスワ
ード
Web サービス時の基本認証パスワード（基本認証使用時）
Web サービス時の基本認証ユーザ名（基本認証使用時）
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分（作成する）プロダクト ID（作成する）シリアル No.
（作成する）ライセンス数
有 効 期 限 利 用 の 有 無 （ False ： 利 用 し な い 、
True：利用する）
有効期限「認証レスキュー！.NET」 ユーザーズガイド- 345 -

APIxExternalLinkKey
APIxFreeItem1～5

外部データベースとのリンク用キー項目を設定
自由入力項目 1～5 を設定【解説】
このメソッドは、製品 1 本分の認証キー情報を新規に作成します。
認証キー情報とは、プロダクト ID、シリアル No.、ライセンス数、有効期限利用の有無、有効期限などの総称です。
認証管理システム（InsideSystem.exe）の「認証キー作成（個別）」処理と同等の機能を提供します。
◆「認証キー作成（個別）」処理の画面例（参考）◆処理手順
一連の処理の手順は次の通りです。
[1]上記の【必須設定プロパティ】一覧にある各プロパティに適切な値を設定します。
[2]当メソッド（APIxCreateOneActivationKey メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 346 -

APIxCreateRandomActivationKey メソッド
【機能】
製品の認証キー情報を指定した数だけ、シリアル No.をランダムに自動作成します。
【構文】<VB.NET>
Public Function APIxCreateRandomActivationKey () As Integer<C#>public int APIxCreateRandomActivationKey ()

【引数】
なし
【戻り値】
生成されたシリアル No.の数。
エラー時は 0 が設定され、戻り値とは別に、APIxErrorStatus プロパティに当メソッド実行後のエラー
内容がセットされます。
また、APIxSerialNoString プロパティに新しく生成されたシリアル No.をデリミタのカンマ（，）で区切った文字列が設定されます。シリアル No.の未生成時は、""（空文字列）が設定されます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
プロパティ
APIxUseProxyServer
APIxProxyServerAddress
APIxProxyServerPort
APIxProxyServerUserName
APIxProxyServerPassword
APIxWebServiceBasicAuthenticationPassword
APIxWebServiceBasicAuthenticationUserName
APIxWebServiceCheckPassword
APIxWebServiceTimeout
APIxWebServiceURL
APIxWebServiceUseBasicAuthentication
APIxProductID
APIxLicenseCount
APIxUseExpirationDate
APIxExpirationDate
APIxStartFixedString
APIxKindOfRandom

機能プロキシサーバーの使用区分
プロキシサーバーのアドレ プロキシサーバ
スー使用時
プロキシサーバーのポート
プロキシサーバーのユーザ名
プロキシサーバーのパスワ
ード
Web サービス時の基本認証パスワード（基本認証使用時）
Web サービス時の基本認証ユーザ名（基本認証使用時）
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分
プロダクト ID
ライセンス数有 効 期 限 利 用 の 有 無 （ False ： 利 用 し な い 、
True：利用する）
有効期限
シリアル No.の上位固定文字列
シリアル No.のランダム文字種の指定「認証レスキュー！.NET」 ユーザーズガイド- 347 -

APIxNumberingCount
APIxExternalLinkKey
APIxFreeItem1～5

0：数字のみ、1：数字と英字（大文字）、2：数字と英字（小文字）、3：数字と英字（大小文字）作成するシリアル No.の数
外部データベースとのリンク用キー項目を設定
自由入力項目 1～5 を設定【解説】
このメソッドは、認証キー情報を指定した数だけ、シリアル No.をランダムに自動作成します。
認証キー情報とは、プロダクト ID、シリアル No.、ライセンス数、有効期限利用の有無、有効期限などの総称です。
認証管理システム（InsideSystem.exe）の「認証キー作成（ランダム生成）」処理と同等の機能を提供します。
◆「認証キー作成（ランダム生成）」処理の画面例（参考）◆処理手順
一連の処理の手順は次の通りです。
[1]上記の【必須設定プロパティ】一覧にある各プロパティに適切な値を設定します。
[2]当メソッド（APIxCreateRandomActivationKey メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 348 -

APIxDeleteActivationKey メソッド【機能】
作成済みの認証キー情報を削除します。
【構文】<VB.NET>
Public Function APIxDeleteActivationKey () As Integer<C#>public int APIxDeleteActivationKey ()

【引数】
なし
【戻り値】
削除に成功した場合は 1 が設定されます。
エラー時は 0 が設定され、戻り値とは別に、APIxErrorStatus プロパティに当メソッド実行後のエラー
内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
プロパティ
APIxUseProxyServer
APIxProxyServerAddress
APIxProxyServerPort
APIxProxyServerUserName
APIxProxyServerPassword
APIxWebServiceBasicAuthenticationPassword
APIxWebServiceBasicAuthenticationUserName
APIxWebServiceCheckPassword
APIxWebServiceTimeout
APIxWebServiceURL
APIxWebServiceUseBasicAuthentication
APIxProductID
APIxSerialNo

機能プロキシサーバーの使用区分
プロキシサーバーのアドレ プロキシサーバ
スー使用時
プロキシサーバーのポート
プロキシサーバーのユーザ名
プロキシサーバーのパスワ
ード
Web サービス時の基本認証パスワード（基本認証使用時）
Web サービス時の基本認証ユーザ名（基本認証使用時）
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分（削除する）プロダクト ID（削除する）シリアル No.

【解説】
このメソッドは、作成済みの認証キー情報を削除します。
認証キー情報とは、プロダクト ID、シリアル No.、ライセンス数、有効期限利用の有無、有効期限などの総称です。
認証管理システム（InsideSystem.exe）の「認証キー削除（個別）」処理と同等の機能を提供します。

「認証レスキュー！.NET」 ユーザーズガイド- 349 -

指定した認証キーテーブルの「プロダクト ID」+「シリアル No.」が認証データテーブルに存在する場
合は、そのレコードもすべて削除されます。
◆「認証キー作成（個別）」処理の画面例（参考）◆処理手順
一連の処理の手順は次の通りです。
[1]上記の【必須設定プロパティ】一覧にある各プロパティに適切な値を設定します。
[2]当メソッド（APIxDeleteActivationKey メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 350 -

APIxEditOfExpirationDate メソッド【機能】
既存の認証キー情報内の有効期限を変更します。
【構文】<VB.NET>
Public Function APIxEditOfExpirationDate () As Integer<C#>public int APIxEditOfExpirationDate ()

【引数】
なし
【戻り値】
有効期限の変更に成功した場合は 1 が設定されます。
エラー時は 0 が設定され、戻り値とは別に、APIxErrorStatus プロパティに当メソッド実行後のエラー
内容がセットされます。
【必須設定プロパティ】
このメソッドの利用には、あらかじめ次のプロパティに適切な値が設定されている必要があります。
プロパティ
APIxUseProxyServer
APIxProxyServerAddress
APIxProxyServerPort
APIxProxyServerUserName
APIxProxyServerPassword
APIxWebServiceBasicAuthenticationPassword
APIxWebServiceBasicAuthenticationUserName
APIxWebServiceCheckPassword
APIxWebServiceTimeout
APIxWebServiceURL
APIxWebServiceUseBasicAuthentication
APIxProductID
APIxSerialNo
APIxUseExpirationDate
APIxExpirationDate

機能プロキシサーバーの使用区分
プロキシサーバーのアドレ プロキシサーバ
スー使用時
プロキシサーバーのポート
プロキシサーバーのユーザ名
プロキシサーバーのパスワ
ード
Web サービス時の基本認証パスワード（基本認証使用時）
Web サービス時の基本認証ユーザ名（基本認証使用時）
Web サービス確認パスワード
Web サービスのタイムアウト
Web サービスの URL
Web サービス時の基本認証の使用区分（有効期限を変更する）プロダクト ID（有効期限を変更する）シリアル No.
有 効 期 限 利 用 の 有 無 （ False ： 利 用 し な い 、
True：利用する）（新しい）有効期限【解説】
このメソッドは、既存の認証キー情報の内の有効期限を変更します。
認証キー情報とは、プロダクト ID、シリアル No.、ライセンス数、有効期限利用の有無、有効期限な「認証レスキュー！.NET」 ユーザーズガイド- 351 -

どの総称です。
認証管理システム（InsideSystem.exe）の「認証キー編集（表形式）」処理の一部と同等の機能を提供します。
◆「認証キー編集（表形式）」処理の画面例（参考）◆処理手順
一連の処理の手順は次の通りです。
[1]上記の【必須設定プロパティ】一覧にある各プロパティに適切な値を設定します。
[2]当メソッド（APIxEditOfExpirationDate メソッド）を実行します。

「認証レスキュー！.NET」 ユーザーズガイド- 352 -

代理認証機能について
次の 8 つのメソッド
1.「代理認証登録/準備」処理の呼び出し/ProxyActivateRegisterPrepare
2.「代理認証登録/確定」処理の呼び出し/ProxyActivateRegisterFix
3.「代理認証解除/準備」処理の呼び出し/ProxyActivateRemovePrepare
4.「代理有効期限更新/準備」処理の呼び出し/PreparationOfProxyUpdateOfExpirationDate
5.「代理有効期限更新/確定」処理の呼び出し/DeterminationOfProxyUpdateOfExpirationDate
6.「代理認証登録/実行」処理の呼び出し（代理 PC で利用）/ProxyActivateRegisterExecute
7.「代理認証解除/実行」処理の呼び出し（代理 PC で利用）/ProxyActivateRemoveExecute
8.「代理有効期限/取得」処理の呼び出し（代理 PC で利用）/GetProxyUpdateOfExpirationDate
は代理で認証する機能です。
これらの機能は、実際にライセンスの認証登録をして貴社のアプリケーションを動作させたいエンド
ユーザの PC がインターネット経由での認証ができない状態で、かつ貴社も電話による認証を受け付ける体制をもたない場合の手段として利用できます。
これは、エンドユーザにとっては電話で認証する場合と違い貴社の休業日でも認証でき、貴社にとっては電話受付による人材や体制のためのコストが不要になる、という双方にとってのメリットがあります。
代理認証は、エンドユーザがこの機能を使ってインターネット接続できる他の PC で代わりに認証をして、その認証情報を貴社のアプリケーションを動作させたい PC に保存する、というものです。
次図のような流れになります。

代理認証
データ

代理PC

認証PC

この代理認証機能を使用しないのであれば以降の記載は必要ありませんので読み飛ばしてください。
◆エンドユーザが行う処理＜代理認証登録＞
・最終的に認証登録したい PC で、「代理認証登録/準備」処理を行い、代理認証準備データを USB
メモリなどに出力します。
・代理に使う PC で、代理認証準備データを読込み「代理認証登録/実行」処理をインターネット経由で行い、代理認証実行データを USB メモリなどに出力します。
・最終的に認証登録したい PC で、代理認証実行データを読込み「代理認証登録/確定」処理を行い認証登録が確定します。
「認証レスキュー！.NET」 ユーザーズガイド- 353 -

＜代理認証解除＞
・最終的に認証解除したい PC で、「代理認証解除/準備」処理を行い、代理認証準備データを USB
メモリなどに出力します。この時点で認証 PC の認証は解除されます。
・代理に使う PC で、代理認証準備データを読込み「代理認証解除/実行」処理をインターネット経由で行い、認証解除が確定します。
＜代理有効期限更新＞
・最終的に認証登録済の有効期限を更新したい PC で、「代理有効期限更新/準備」処理を行い、代理有効期限更新準備データを USB メモリなどに出力します。
・代理に使う PC で、代理有効期限更新準備データを読込み「代理有効期限/取得」処理をインターネット経由で行い、代理有効期限取得データを USB メモリなどに出力します。
・最終的に認証登録済の有効期限を更新したい PC で、代理有効期限取得データを読込み「代理有効期限更新/確定」処理を行い有効期限の更新が確定します。
◆貴社が行う作業
上記の「エンドユーザが行う処理」をエンドユーザに操作させるために認証 UI ライブラリ（DLL）を利用してアプリケーションに代理機能を組み込む必要があります。
エンドユーザに対し、最終的に認証したい PC で作業させる処理の例は付属の開発言語別のサンプ
ルプロジェクトの PackageApp 内に、代理 PC で作業させる処理の例は付属の開発言語別のサンプ
ルプロジェクトの ProxyApp にそれぞれあります。
したがって、貴社は最終的に認証したい PC 用のアプリケーションの他に代理 PC で代理処理をするための（ProxyApp のような）アプリケーションを作成し配布する必要があります。

「認証レスキュー！.NET」 ユーザーズガイド- 354 -

■認証 UI ライブラリの参照
Visual Studio 2015（Visual Baisc 2015/C# 2015）の場合
認証レスキュー！の認証 UI ライブラリ（DLL）を使用するプロジェクトの「参照の追加」で Newtone.NR.
FW45.dll を参照します。
<Newtone.NR.FW45.dll を参照した後の参照設定の様子 （Visual Basic 2015）>

また、ASP.NET 系の DLL を使用する場合は、プロジェクトの「参照の追加」で Newtone.NR.ASPNET.
dll を参照します。
<Newtone.NR.ASPNET.dll を参照した後の参照設定の様子 （Visual Basic 2010）>

Newtone.NR.FW45.dll、Newtone.NR.NET6.dlll および Newtone.NR.ASPNET.dll は、インストール先がデフォルトの場合、次のフォルダ内にあります。
<32bitOS の場合> C:\Program Files\Newtone\NRD\NRDDLL\NRDLL<64bitOS の場合> C:\Program Files (x86)\Newtone\NRD\NRDDLL\NRDLL「認証レスキュー！.NET」 ユーザーズガイド- 355 -

■認証 UI ライブラリ（DLL）を利用したコーディング <既定 UI 系の場合>
Visual Baisc 2015 の場合付属のサンプルプロジェクト（NRDDLL\SampleProject\VisualBasic\PackageApp\SamplePackageA
pp.FW45）の例で説明します。
最初に、Newtone.NR.Activationクラスのインスタンスを作成します。
次の例では、2つのFormで同一のインスタンスで使用するためクラスClass1内でPublic Sharedで宣言しています。
Public Class Class1
Public Shared myActivate As Newtone.NR.FW45.NRD_Activation = New Newtone.NR.FW45.NRD_Activation()
End Class

次に DLL のプロパティを設定します。
これらのプロパティは通常、最初に 1 回だけ固定的に設定するコードを記述します。
Public Class Form1
Private Sub Form1_Load(sender As System.Object, e As System.EventArgs) Handles MyBase.Load'------------------------------------------------------------------'Newtone.NR.FW45.dllのプロパティの設定'【重要】DLLの以下のプロパティは必ず適切なものを設定してください。
'------------------------------------------------------------------'ベンダ製品スタート開始レジストリキーパス（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.VendorsProductStartRegistryKeyPath ="Software\Newtone\NinshoRescue\NRD\SampleProject"'電話で認証時の電話番号（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.TelephoneNumber = "012-345-6789"'暗号化時のパスワード（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.EncryptionPassword = "12345678ABCDEFGH"'暗号化時のSalt文字列(8バイト以上)（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.EncryptionSaltString = "認証レスキュー！"'猶予日数（デフォルト：0日、設定可能範囲：1～365日）（※最終的には必ず貴社のものに変更してください）Class1.myActivate.TrialPeriod = 0'猶予期間の名称（デフォルト："猶予（試用）期間"）
Class1.myActivate.TrialPeriodName = "猶予（試用）"'MACアドレスの使用（デフォルト：True）「代理認証」利用時はMACアドレス必須Class1.myActivate.UseMacAddress = True
'CPU情報の使用（デフォルト：True）
Class1.myActivate.UseCpuInfo = True
'WebサービスのURL（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.WebServiceURL = "http://localhost/NRDWebService/Service.asmx"'Webサービス時の基本認証の使用（デフォルト：False）
Class1.myActivate.WebServiceUseBasicAuthentication = False'Webサービス時の基本認証ユーザ名
Class1.myActivate.WebServiceBasicAuthenticationUserName = ""'Webサービス時の基本認証パスワード
Class1.myActivate.WebServiceBasicAuthenticationPassword = ""「認証レスキュー！.NET」 ユーザーズガイド- 356 -

'Webサービス確認パスワード（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.WebServiceCheckPassword = "ABcd1234"'プロダクトIDの桁数（デフォルト：17）（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.ProductIdNumberOfDigits = 17
'シリアルNo.の桁数（デフォルト：8）（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.SerialNoNumberOfDigits = 8'Webサービスのタイムアウト（デフォルト：60秒）
Class1.myActivate.WebServiceTimeout = 60
'認証登録時の設定プロダクトID（デフォルト：空文字列）
Class1.myActivate.SetProductID = ""'認証登録時の設定シリアルNo.（デフォルト：空文字列）
Class1.myActivate.SetSerialNo = ""'無効になっているNICを無視する（高速化を図る）（デフォルト：True）
Class1.myActivate.DisabledNICIgnore = True
CertificationStatus() '認証状況の確認
End Sub・・・
End Class後は、必要に応じてDLLのメソッドを呼び出します。
次の例では、ActivateStatusCheck()メソッドで「認証状態確認」を行います。
Public Class Form1
Private Sub CertificationStatus()'---------------------------------------'認証状況の確認'---------------------------------------'Button1、Button2、Button3 を含む GroupBox1 の Enabled プロパティを False にして無効とする。
GroupBox1.Enabled = False
Dim ret As Integer
Dim stat As String '表示メッセージ
ret = Class1.myActivate.ActivateStatusCheck()'認証状況確認
Select Case ret
Case 0 '期限切れ（猶予有効時）
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"[ID:" + ret.ToString + "] " + Class1.myActivate.TrialPeriodName + "期限が切れました。" + vbCr + "メニューは実行できません。" + vbCr + "「ライセンス管理」からライセンスの認証登録を行ってください。"
MessageBox.Show(stat,
"
認
証
確
認
",
MessageBoxButtons.OK,
MessageBoxIcon.Exclamation)
Label2.Text ="現在、「猶予（試用）期限切れ」のため「処理メニュー」は" + vbCr +「認証レスキュー！.NET」 ユーザーズガイド- 357 -

"グレーアウトになっています。"
Case 1 To 365 '猶予日数有
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"[ID:" + ret.ToString + "] " + Class1.myActivate.TrialPeriodName + "期間残日数は" + ret.ToString + "日です。" + vbCr + "続行します。"
MessageBox.Show(stat,
"
認
証
確
認
",
MessageBoxButtons.OK,
MessageBoxIcon.Information)'猶予（試用）残日数があるので、Button1、Button2、Button3 を含む'GroupBox1 の Enabled プロパティを True にして有効とする。
GroupBox1.Enabled = TrueLabel2.Text ="現在、「猶予（試用）期間内」のため「処理メニュー」を" + vbCr +"表示しています。"
Case 400 '未認証（猶予無効時）
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"[ID:" + ret.ToString + "] " + "ライセンスが認証されていません。" + vbCr + "メニューは実行できません。" + vbCr + "「ライセンス管理」からライセンスの認証登録を行ってください。"
MessageBox.Show(stat,
MessageBoxIcon.Exclamation)

"

認

証

確

認

",

MessageBoxButtons.OK,

Label2.Text ="現在、「未承認」のため「処理メニュー」はグレーアウトに" + vbCr +"なっています。"
Case 500 '認証済み'認証済みなので、Button1、Button2、Button3 を含む'GroupBox1 の Enabled プロパティを True にして有効とする。
GroupBox1.Enabled = TrueLabel2.Text ="現在、「認証済」のため「処理メニュー」を表示しています。"
Case -999 '認証済ハードウェア情報不一致
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"[ID:" + ret.ToString + "] " + "認証済ですが認証時のハードウェア情報と一致しない情報があります。"
MessageBox.Show(stat,
"
認
証
確
認
",
MessageBoxButtons.OK,
MessageBoxIcon.Exclamation)
Label2.Text ="現在、「認証済ハードウェア情報不一致」のため「処理メニュー」は" + vbCr +"グレーアウトになっています。"
Case -1 'その他エラー
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"[ID:" + ret.ToString + "] " + "認証状況確認中に何らかのエラーが発生しました。"
MessageBox.Show(stat,
"
認
証
確
認
",
MessageBoxButtons.OK,
MessageBoxIcon.Exclamation)「認証レスキュー！.NET」 ユーザーズガイド- 358 -

Label2.Text ="現在、「その他エラー」のため「処理メニュー」はグレーアウト" + vbCr +"になっています。"
Case 20000101 To 21001231 '「有効期限」以内
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"有効期限は、" + Mid(ret, 1, 4) + "/" + Mid(ret, 5, 2) + "/" + Mid(ret, 7, 2) + "までです。 "
MessageBox.Show(stat,"
MessageBoxIcon.Information)
GroupBox1.Enabled = True

認

証

確

認

",

MessageBoxButtons.OK,

Label2.Text ="現在、「認証登録済/有効期間内」のため「処理メニュー」を" + vbCr +"表示しています。"
Case -21001231 To -20000101 '「有効期限」以外
ret = ret * -1
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"有効期限は、" + Mid(ret, 1, 4) + "/" + Mid(ret, 5, 2) + "/" + Mid(ret, 7, 2) + "までです。 "
stat = stat + vbCr + "有効期限が切れました。"
MessageBox.Show(stat,
"
認
証
確
認
MessageBoxIcon.Exclamation)",

MessageBoxButtons.OK,

Label2.Text ="現在、「認証登録済/有効期限切れ」のため「処理メニュー」は" + vbCr +"グレーアウトになっています。"
Case 366 '日付データの取得失敗（猶予）stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"日付データの取得に失敗しました。（猶予）"MessageBox.Show(stat,
"
認
証
確
認
",
MessageBoxButtons.OK,
MessageBoxIcon.Exclamation)
Label2.Text ="現在、「日付データの取得失敗（猶予）」のため「処理メニュー」は" + vbCr +"グレーアウトになっています。"
Case -21001232 '日付データの取得失敗（有効期限）
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"日付データの取得に失敗しました。（有効期限）"
MessageBox.Show(stat,
"
認
証
確
認
",
MessageBoxButtons.OK,
MessageBoxIcon.Exclamation)
Label2.Text ="現在、「日付データの取得失敗（有効期限）」のため「処理メニュー」は" + vbCr +"グレーアウトになっています。"
Case -3 'PC の日付が意図的に変更された
stat =「認証レスキュー！.NET」 ユーザーズガイド- 359 -

"********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"PC の日付が変更されました。"
MessageBox.Show(stat,"認証
確MessageBoxIcon.Exclamation)

認",

MessageBoxButtons.OK,

Label2.Text ="現在、「PC の日付が意図的に変更された」ため「処理メニュー」は" + vbCr +"グレーアウトになっています。"
Case 600 'フローティングライセンス PC として登録済
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"フローティングライセンス登録済です。"
MessageBox.Show(stat,
"
認
証
確
認
",
MessageBoxButtons.OK,
MessageBoxIcon.Information)
GroupBox1.Enabled = TrueLabel2.Text ="現在、「フローティングライセンス登録済」のため「処理メニュー」を" + vbCr +"表示しています。"
Case 200001010 To 210012310 '「有効期限」以内で フローティングライセンスが登録済
ret = ret / 10
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"有効期限は、" + Mid(ret, 1, 4) + "/" + Mid(ret, 5, 2) + "/" + Mid(ret, 7, 2) + "までです。 "
MessageBox.Show(stat,"
MessageBoxIcon.Information)
GroupBox1.Enabled = True

認

証

確

認

",

MessageBoxButtons.OK,

Label2.Text ="現在、「フローティングライセンス登録済/有効期間内」のため" + vbCr +"「処理メニュー」を表示しています。"
Case -210012310 To -200001010 '「有効期限」以外でフローティングライセンスが登録済
ret = ret / -10
stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +"有効期限は、" + Mid(ret, 1, 4) + "/" + Mid(ret, 5, 2) + "/" + Mid(ret, 7, 2) + "までです。 "
stat = stat + vbCr + "有効期限が切れました。"
MessageBox.Show(stat,
"
認
証
確
認
MessageBoxIcon.Exclamation)",

MessageBoxButtons.OK,

Label2.Text ="現在、「フローティングライセンス登録済/有効期限切れ」のため" + vbCr +"「処理メニュー」はグレーアウトになっています。"
Case Else '想定外stat ="********************************" + vbCr +"これは、サンプルメッセージです。" + vbCr +"********************************" + vbCr +「認証レスキュー！.NET」 ユーザーズガイド- 360 -

"[ID:" + ret.ToString + "] " + "認証状況確認中に想定外のエラーが発生しました。"
MessageBox.Show(stat)
Label2.Text ="現在、「想定外のエラー」のため「処理メニュー」は" + vbCr +"グレーアウトになっています。"
End SelectEnd Sub・・・
End Class

次の例では、認証状況表示ダイアログを呼び出しています。
Public Class Form2
Private Sub Button1_Click(sender As System.Object, e As System.EventArgs) Handles Button1.Click' 認証状況表示
If Class1.myActivate.ActivateStatusDisp() = False Then
MessageBox.Show("エラー")
End IfEnd Sub・・・
End Class

以下の例では、認証の登録や解除に関する各処理を呼び出しています。
Public Class Form2
Private Sub Button2_Click(sender As System.Object, e As System.EventArgs) Handles Button2.Click'認証登録/インターネット
If Class1.myActivate.ActivateRegisterInternet() = False Then
MessageBox.Show("エラー")
End IfEnd Sub

Private Sub Button3_Click(sender As System.Object, e As System.EventArgs) Handles Button3.Click'認証登録/電話
If Class1.myActivate.ActivateRegisterTelephone() = False Then
MessageBox.Show("エラー")
End IfEnd Sub
Private Sub Button4_Click(sender As System.Object, e As System.EventArgs) Handles Button4.Click'認証解除/インターネット
If Class1.myActivate.ActivateRemoveInternet() = False Then
MessageBox.Show("エラー")
End If「認証レスキュー！.NET」 ユーザーズガイド- 361 -

End Sub
Private Sub Button5_Click(sender As System.Object, e As System.EventArgs) Handles Button5.Click'認証解除/電話
If Class1.myActivate.ActivateRemoveTelephone() = False Then
MessageBox.Show("エラー")
End IfEnd Sub
Private Sub Button6_Click(sender As System.Object, e As System.EventArgs) Handles Button6.Click'代理認証登録/準備
If Class1.myActivate.ProxyActivateRegisterPrepare() = False Then
MessageBox.Show("エラー")
End IfEnd Sub
Private Sub Button7_Click(sender As System.Object, e As System.EventArgs) Handles Button7.Click'代理認証登録/確定
If Class1.myActivate.ProxyActivateRegisterFix() = False Then
MessageBox.Show("エラー")
End IfEnd Sub
Private Sub Button8_Click(sender As System.Object, e As System.EventArgs) Handles Button8.Click'代理認証解除/準備
If Class1.myActivate.ProxyActivateRemovePrepare() = False Then
MessageBox.Show("エラー")
End IfEnd Sub・・・
End Class「認証レスキュー！.NET」 ユーザーズガイド- 362 -

C# 2015 の場合付属のサンプルプロジェクト（NRDDLL\SampleProject\CSharp\PackageApp\SamplePackageApp.F
W45）の例で説明します。
最初に、Newtone.NR.Activationクラスのインスタンスを作成します。
次の例では、2つのFormで同一のインスタンスで使用するためクラスClass1内でpublic staticで宣言しています。
class Class1{
public static Newtone.NR.FW45.NRD_Activation myActivate = new
Newtone.NR.FW45.NRD_Activation();}

次に DLL のプロパティを設定します。
これらのプロパティは通常、最初に 1 回だけ固定的に設定するコードを記述します。
public partial class Form1 : Form{
private void Form1_Load(object sender, EventArgs e){//------------------------------------------------------------------//Newtone.NR.FW45.dllのプロパティの設定//【重要】DLLの以下のプロパティは必ず適切なものを設定してください。
//------------------------------------------------------------------//ベンダ製品スタート開始レジストリキーパス（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.VendorsProductStartRegistryKeyPath ="Software\\Newtone\\NinshoRescue\\NRD\\SampleProject";//電話で認証時の電話番号（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.TelephoneNumber = "012-345-6789";//暗号化時のパスワード（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.EncryptionPassword = "12345678ABCDEFGH";//暗号化時のSalt文字列(8バイト以上)（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.EncryptionSaltString = "認証レスキュー！";//猶予日数（デフォルト：0日、設定可能範囲：1～365日）（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.TrialPeriod = 0;//猶予期間の名称（デフォルト："猶予（試用）"）Class1.myActivate.TrialPeriodName = "猶予（試用）";//MACアドレスの使用（デフォルト：True）「代理認証」利用時はMACアドレス必須Class1.myActivate.UseMacAddress = true;//CPU情報の使用（デフォルト：True）
Class1.myActivate.UseCpuInfo = true;//WebサービスのURL（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.WebServiceURL = "http://localhost/NRDWebService/Service.asmx";//Webサービス時の基本認証の使用（デフォルト：False）
Class1.myActivate.WebServiceUseBasicAuthentication = false;//Webサービス時の基本認証ユーザ名
Class1.myActivate.WebServiceBasicAuthenticationUserName = "";//Webサービス時の基本認証パスワード
Class1.myActivate.WebServiceBasicAuthenticationPassword = "";//Webサービス確認パスワード（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.WebServiceCheckPassword = "ABcd1234";//プロダクトIDの桁数（デフォルト：17）（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.ProductIdNumberOfDigits = 17;「認証レスキュー！.NET」 ユーザーズガイド- 363 -

//シリアルNo.の桁数（デフォルト：8）（※最終的には必ず貴社のものに変更してください）
Class1.myActivate.SerialNoNumberOfDigits = 8;//Webサービスのタイムアウト（デフォルト：60秒）
Class1.myActivate.WebServiceTimeout = 60;//認証登録時の設定プロダクトID（デフォルト：空文字列）
Class1.myActivate.SetProductID = "";//認証登録時の設定シリアルNo.（デフォルト：空文字列）
Class1.myActivate.SetSerialNo = "";//無効になっているNICを無視する（高速化を図る）（デフォルト：True）
Class1.myActivate.DisabledNICIgnore = true;
CertificationStatus(); //認証状況の確認}
・・・}

後は、必要に応じてDLLのメソッドを呼び出します。
次の例では、ActivateStatusCheck()メソッドで「認証状態確認」を行います。
public partial class Form1 : Form{
private void CertificationStatus(){//---------------------------------------//認証状況の確認//---------------------------------------//Button1、Button2、Button3を含むGroupBox1のEnabledプロパティをFalseにして無効とする。
GroupBox1.Enabled = false;
int ret = 0;
string stat = null;//表示メッセージ
ret = Class1.myActivate.ActivateStatusCheck();//認証状況確認

if (ret>=1 && ret<=365){//猶予日数有
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"[ID:" + ret.ToString() + "] " + Class1.myActivate.TrialPeriodName + "期間残日数は" + ret.ToString() + "日です。" + Environment.NewLine + "続行します。";
MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK, MessageBoxIcon.Information);//猶予（試用）残日数があるので、Button1、Button2、Button3を含む//GroupBox1のEnabledプロパティをTrueにして有効とする。
GroupBox1.Enabled = true;
Label2.Text =「認証レスキュー！.NET」 ユーザーズガイド- 364 -

"現在、「猶予（試用）期間内」のため「処理メニュー」を" + Environment.NewLine +"表示しています。";
return;}if (ret >= 20000101 && ret <= 21001231){//「有効期限」以内
String retStr = "";retStr = ret.ToString();
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"有効期限は、" + retStr.Substring(0, 4) + "/" + retStr.Substring(4, 2) + "/" +retStr.Substring(6, 2) + "までです。 ";MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK, MessageBoxIcon.Information);GroupBox1.Enabled = true;
Label2.Text ="現在、「認証登録済/有効期間内」のため「処理メニュー」を" + Environment.NewLine +"表示しています。";
return;}if (ret >= -21001231 && ret <= -20000101){//「有効期限」以外
String retStr = "";ret = ret * -1;
retStr = ret.ToString();
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"有効期限は、" + retStr.Substring(0, 4) + "/" + retStr.Substring(4, 2) + "/" +retStr.Substring(6, 2) + "までです。 ";stat = stat + Environment.NewLine + "有効期限が切れました。";
MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);Label2.Text ="現在、「認証登録済/有効期限切れ」のため「処理メニュー」は" + Environment.NewLine+"グレーアウトになっています。";
return;}if (ret >= 200001010 && ret <= 210012310){//「有効期限」以内で フローティングライセンスが登録済「認証レスキュー！.NET」 ユーザーズガイド- 365 -

ret = ret / 10;
String retStr = "";retStr = ret.ToString();
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"有効期限は、" + retStr.Substring(0, 4) + "/" + retStr.Substring(4, 2) + "/" +retStr.Substring(6, 2) + "までです。";
MessageBox.Show(stat, "フローティングライセンス", MessageBoxButtons.OK,
MessageBoxIcon.Information);GroupBox1.Enabled = true;
Label2.Text ="現在、「フローティングライセンス登録済/有効期間内」のため" + Environment.NewLine+"「処理メニュー」を表示しています。";
return;}if (ret >= -210012310 && ret <= -200001010){//「有効期限」以外でフローティングライセンスが登録済
ret = ret / -10;String retStr = "";ret = ret * -1;
retStr = ret.ToString();
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"有効期限は、" + retStr.Substring(0, 4) + "/" + retStr.Substring(4, 2) + "/" +retStr.Substring(6, 2) + "までです。";
stat = stat + Environment.NewLine + "有効期限が切れました。";
MessageBox.Show(stat, "フローティングライセンス", MessageBoxButtons.OK,
MessageBoxIcon.Exclamation);Label2.Text ="現在、「フローティングライセンス登録済/有効期限切れ」のため" + Environment.NewLine+"「処理メニュー」はグレーアウトになっています。";
return;}switch (ret){case 0://期限切れ（猶予有効時）
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"[ID:" + ret.ToString() + "] " + Class1.myActivate.TrialPeriodName + "期限が「認証レスキュー！.NET」 ユーザーズガイド- 366 -

切れました。" + Environment.NewLine + "メニューは実行できません。" + Environment.NewLine + "「ライセンス管理」からライセンスの認証登録を行ってください。";
MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK,
MessageBoxIcon.Exclamation);Label2.Text ="現在、「猶予（試用）期限切れ」のため「処理メニュー」は" + Environment.NewLine+"グレーアウトになっています。";
break;
case 400://未認証（猶予無効時）
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"[ID:" + ret.ToString() + "] " + "ライセンスが認証されていません。" +Environment.NewLine + "メニューは実行できません。" + Environment.NewLine + "「ライセンス管理」からライセンスの認証登録を行ってください。";
MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK,
MessageBoxIcon.Exclamation);Label2.Text ="現在、「未承認」のため「処理メニュー」はグレーアウトに" + Environment.NewLine+"なっています。";
break;
case 500://認証済み//認証済みなので、Button1、Button2、Button3を含む//GroupBox1のEnabledプロパティをTrueにして有効とする。
GroupBox1.Enabled = true;
Label2.Text ="現在、「認証済」のため「処理メニュー」を表示しています。";
break;
case -999://認証済ハードウェア情報不一致
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"[ID:" + ret.ToString() + "] " + "認証済ですが認証時のハードウェア情報と一致しない情報があります。";
MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK,
MessageBoxIcon.Exclamation);Label2.Text ="現在、「認証済ハードウェア情報不一致」のため「処理メニュー」は" +Environment.NewLine +"グレーアウトになっています。";
break;「認証レスキュー！.NET」 ユーザーズガイド- 367 -

case -1://その他エラー
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"[ID:" + ret.ToString() + "] " + "認証状況確認中に何らかのエラーが発生しました。";
MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK,
MessageBoxIcon.Exclamation);Label2.Text ="現在、「その他エラー」のため「処理メニュー」はグレーアウト" +Environment.NewLine +"になっています。";
break;
case 366://日付データの取得失敗（猶予）stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"日付データの取得に失敗しました。（猶予）";
MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK,
MessageBoxIcon.Exclamation);Label2.Text ="現在、「日付データの取得失敗（猶予）」のため「処理メニュー」は" +Environment.NewLine +"グレーアウトになっています。";
break;
case -21001232://日付データの取得失敗（有効期限）
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"日付データの取得に失敗しました。（有効期限）";MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK,
MessageBoxIcon.Exclamation);Label2.Text ="現在、「日付データの取得失敗（有効期限）」のため「処理メニュー」は" +Environment.NewLine +"グレーアウトになっています。";
break;
case -3://PCの日付が意図的に変更された
stat ="********************************" + Environment.NewLine +「認証レスキュー！.NET」 ユーザーズガイド- 368 -

"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"PCの日付が変更されました。";
MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK,
MessageBoxIcon.Exclamation);Label2.Text ="現在、「PCの日付が意図的に変更された」ため「処理メニュー」は" +Environment.NewLine +"グレーアウトになっています。";
break;
case 600://フローティングライセンスPCとして登録済
stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"フローティングライセンス登録済です。";
MessageBox.Show(stat, "認証確認", MessageBoxButtons.OK,
MessageBoxIcon.Information);GroupBox1.Enabled = true;
Label2.Text ="現在、「フローティングライセンス登録済」のため「処理メニュー」を" +Environment.NewLine +"表示しています。";
break;
default://想定外stat ="********************************" + Environment.NewLine +"これは、サンプルメッセージです。" + Environment.NewLine +"********************************" + Environment.NewLine +"[ID:" + ret.ToString() + "] " + "認証状況確認中に想定外のエラーが発生しました";MessageBox.Show(stat);Label2.Text ="現在、「想定外のエラー」のため「処理メニュー」は" + Environment.NewLine +"グレーアウトになっています。";
break;}}
・・・}

次の例では、認証状況表示ダイアログを呼び出しています。
public partial class Form2 : Form

「認証レスキュー！.NET」 ユーザーズガイド- 369 -

{
private void Button1_Click(object sender, EventArgs e){// 認証状況表示
if (Class1.myActivate.ActivateStatusDisp() == false){
MessageBox.Show("エラー");}}}以下の例では、認証の登録や解除に関する各処理を呼び出しています。
public partial class Form2 : Form{
private void Button2_Click(object sender, EventArgs e){//認証登録/インターネット
if (Class1.myActivate.ActivateRegisterInternet() == false){
MessageBox.Show("エラー");}}
private void Button3_Click(object sender, EventArgs e){//認証登録/電話
if (Class1.myActivate.ActivateRegisterTelephone() == false){
MessageBox.Show("エラー");}}
private void Button4_Click(object sender, EventArgs e){//認証解除/インターネット
if (Class1.myActivate.ActivateRemoveInternet() == false){
MessageBox.Show("エラー");}}
private void Button5_Click(object sender, EventArgs e){//認証解除/電話
if (Class1.myActivate.ActivateRemoveTelephone() == false){
MessageBox.Show("エラー");}}
private void Button6_Click(object sender, EventArgs e){//代理認証登録/準備
if (Class1.myActivate.ProxyActivateRegisterPrepare() == false){
MessageBox.Show("エラー");}「認証レスキュー！.NET」 ユーザーズガイド- 370 -

}
private void Button7_Click(object sender, EventArgs e){//代理認証登録/確定
if (Class1.myActivate.ProxyActivateRegisterFix() == false){
MessageBox.Show("エラー");}}
private void Button8_Click(object sender, EventArgs e){//代理認証解除/準備
if (Class1.myActivate.ProxyActivateRemovePrepare() == false){
MessageBox.Show("エラー");
}
}
・・・
}

「認証レスキュー！.NET」 ユーザーズガイド- 371 -

■認証 UI ライブラリ（DLL）の配布
・配布が必要なファイル
お客様（エンドユーザ）向けに配布するアプリケーションとともに次のファイルを配布する必要があります。この場合のアプリケーションは、認証 UI ライブラリ（DLL）を使用したアプリケーションを指します。
Newtone.NR.FW45.dll（.NET Framework 4.5～4.8 アプリケーション用）
Newtone.NR.NET6.dll（.NET 6/7/8 アプリケーション用）
これらは、認証レスキュー！の「認証 UI ライブラリ」をインストールしてインストール先がデフォルトの場合、次のフォルダ内にあります。
<32bitOS の場合> C:\Program Files\Newtone\NRD\NRDDLL\NRDLL<64bitOS の場合> C:\Program Files (x86)\Newtone\NRD\NRDDLL\NRDLL
・お客様（エンドユーザ）PC 上での配置
認証 UI ライブラリ（DLL）をお客様（エンドユーザ）向けに配布するアプリケーションとともに配布する
場合、インストーラなどでお客様（エンドユーザ）の PC 上でアプリケーション実行時にパスが通るように配置してください。
配布するアプリケーションと同じフォルダに配置するのが最も簡単な方法です。

「認証レスキュー！.NET」 ユーザーズガイド- 372 -

●認証レスキュー！で使う主なテーブルの概要
ここでは、「認証レスキュー！」で扱う SQL Server のテーブルを確認します。
テーブルは、以下の 3 種類について説明します。
・＜認証キーテーブル＞
・＜認証データテーブル＞
・＜認証ログテーブル＞
以降でそれぞれを詳しく見て行きましょう。

＜認証キーテーブル＞
このテーブルは、ライセンス認証のキーとなるテーブルで、出荷する（アプリケーション）製品１本毎に 1 レコードが追加されます。
たとえば、出荷する製品の 1 本が 4 ライセンス製品であれば、ライセンス数には 4 と入力します。
実際のレコード追加や削除は、社内システムの「認証キー作成」および「認証キー削除」処理で行います。
＜認証キーテーブルの例＞
製品の定義例
製品名

ライセンス

AAA システム Ver.2.0〃〃〃
BBB システム Ver.1〃〃

1 ライセンス〃〃
4 ライセンス
1 ライセンス〃
10 ライセンス

プロダクト ID

シリア
ル No.

ライセ
ンス数

プラス
許可数

00001-00002-00001〃〃
00001-00002-00004
00002-00001-00001〃
00002-00001-00010

A01-0001
A01-0002
A01-0003
A04-0001
B01-0001
B01-0002
B10-0001

1
1
1
4
1
1
10

0
0
0
0
0
0
0

・プラス許可数
これはライセンス認証登録済みのエンドユーザの PC がクラッシュなどに見舞われ、エンドユー
ザの PC ではライセンス認証解除をできないため、OS を再セットアップした PC や別の PC に、
再度アプリケーションのライセンス認証登録ができない場合に使う特別な項目です。
初期値は 0 です。「認証レスキュー！」では、処理の入力項目ではありません。
認証業務用社内 PC の「認証管理システム」の「電話認証解除の対応」処理で、「クラッシュ」オ
プションを指定して認証解除を行った場合にこの「プラス許可数」項目が+1 されます。
この項目の必要性は、後で説明します。

＜認証データテーブル＞
このテーブルは、出荷した製品をエンドユーザがライセンス認証登録を行って成功した場合に 1 レコード追加されます。このテーブルのプロダクト ID とシリアル No.が同一なレコード数がそのまま現在のライセンス数になります。
たとえば、このテーブルに同一の「プロダクト ID とシリアル No.」の組み合わせで 3 レコード存在する「認証レスキュー！.NET」 ユーザーズガイド- 373 -

場合は、現在 3 ライセンス分の認証が登録済みであることになります。
「認証レスキュー！」のライセンス認証のロジックでは、そのことを使用してライセンス数の上限を、前述の＜認証キーテーブル＞に登録した「ライセンス数」項目（と「プラス許可数」項目を足したもの）と比較しチェックしています。
このテーブルへの実際のレコード追加と削除は、次のタイミングで行われます。
インターネットで認証の場合、エンドユーザ PC で実行されるパッケージに組み込まれたプログラムからの呼び出しによる Web サービス内で行われます。
また、電話によるライセンス認証では社内システムの「電話認証登録の対応」、および「電話認証解除の対応」処理で行われます。
＜認証データテーブルの例＞
製品の定義例
ライセン
製品名
ス
AAA シ
1 ライセ
ステム
ンス
Ver.2.0

プロダクト ID

シリアル No.

認証 ID

ライセンス
キー

00001-00002-00001

A01-0001

11111-1111***************〃〃〃

A01-0002

22222-22222

〃

〃

〃

A01-0003

33333-33333

〃

4 ライセ
ンス

00001-00002-00004

A04-0001

44444-44444

〃

〃

〃

〃

55555-55555

〃

〃

〃

BBB シ
ステム
Ver.1

1 ライセ
ンス

00002-00001-00001

B01-0001

77777-77777

〃

10 ライ
センス

00002-00001-00010

B10-0001

88888-88888

〃

〃

〃

〃

99999-99999〃

66666-66666************************************************************************************************************************
4 ライセンス分の 3 ライセ
ンスが既に認証登録されている

・認証 ID
5 桁 - 5 桁 （数字のみ）
エンドユーザ PC 側の認証登録処理時に自動的に発生します。
・ライセンスキー
15 桁 （数字のみ）
上記の「認証 ID」とプロダクト ID、シリアル No.をもとに生成されます。
このライセンスキーは、インターネットでの認証の場合は、Web サービスで生成後エンドユーザ
PC 側の認証登録処理（のプログラム）に返され、プログラムが自動的に処理します。
また、電話での認証登録時はオペレータに電話で伝えられたライセンスキーをエンドユーザが画面で入力して登録します。

「認証レスキュー！.NET」 ユーザーズガイド- 374 -

ここでは、＜認証キーテーブル＞と＜認証データテーブル＞の両方のテーブルの項目説明が終わったところで、両テーブルに密接に関連する「プラス許可数」項目について説明します。
＜認証キーテーブル＞の「プラス許可数」項目の必要性
通常、ライセンス認証登録済みの PC がクラッシュすると、エンドユーザは製品に添付されているプ
ロダクト ID とシリアル No.しかわかりません。認証解除には認証 ID も必要です。
たとえば、製品が 4PC ライセンスといった複数ライセンスの場合、プロダクト ID+シリアル No.は同一ですからこの情報だけでは、4 台中でクラッシュした個体 PC1 台を特定できません。
この場合、＜認証データテーブル＞には、同一のプロダクト ID+シリアル No.を持つレコードは最大で4 レコード存在することになりますが、認証 ID やライセンスキーが分からないのでどのレコードがクラッシュした PC 分なのか判定できません。
＜認証キーテーブル＞
プロダクト ID

シリアル No.

ライセ
ンス
数

1 ライセンス

00001-00002-00001

A01-0001

1

4 ライセンス

00001-00002-00004

A04-0001

4

0

1 ライセンス

00002-00001-00001

B01-000110

製品の定義例
製品名

ライセンス

AAA システム
Ver.2.0〃
BBB システム
Ver.1

プラ
ス許
可数
0

＜認証データテーブル＞
製品の定義例
ライセン
製品名
ス
AAA シ
1 ライセ
ステム
ンス
Ver.2.0
4 ライセ〃ンス

プロダクト ID

シリアル N
o.

認証 ID

ライセン
スキー

00001-00002-00001

A01-0001

11111-1111***************

00001-00002-00004

A04-0001

44444-44444〃

55555-55555

〃

〃

〃

〃

〃

〃

〃

〃

〃

BBB シ
ステム
Ver.1

1 ライセ
ンス

00002-00001-00001〃

66666-66666〃

12345-12345

B01-0001

77777-77777************************************************************

認証 ID が分から な い と、 こ れら 4 レコード分のどの PC 分（レコード）がク
ラッシ ュしたのか分からない***************

また消去法で考えたとして、クラッシュしていない残りの 3 台すべての PC の認証情報をエンドユー
ザから聞き出し煩雑な対応をすることは、エンドユーザはもちろん貴社にとっても得策ではありませんし、仮に 50 ライセンスだったらどうでしょう？ PC49 台分の認証情報をエンドユーザから教えても
らわねばなりません。

「認証レスキュー！.NET」 ユーザーズガイド- 375 -

そこでこれらの解決方法として、前述の通り社内システムの「電話認証解除の対応」処理で、「クラッシュ」オプションを指定して認証解除を行い「プラス許可数」項目が+1 されると、「ライセンス数」+「プラス許可数」の合計が最大ライセンス数としてみなされ、未登録のライセンス数に 1 ライセンス分の猶予ができるわけです。
＜認証キーテーブル＞
製品の定義例
製品名

プラ
ス許
可数

1

0

プロダクト ID

シリアル No.

1 ライセンス

00001-00002-00001

A01-0001

4 ライセンス

00001-00002-00004

A04-0001

4

1

1 ライセンス

00002-00001-00001

B01-0001

1

0

ライセンス

AAA システム
Ver.2.0〃
BBB システム
Ver.1

ライセ
ンス
数

合計 5 ライセンス（＜認証 データ テーブル＞上での 5
レコード）まで登録可能となる＜認証データテーブル＞
製品の定義例
ライセン
製品名
ス
AAA シ
1 ライセ
ステム
ンス
Ver.2.0
4 ライセ〃ンス

プロダクト ID

シリアル N
o.

認証 ID

ライセン
スキー

00001-00002-00001

A01-0001

11111-1111***************

00001-00002-00004

A04-0001

44444-44444〃

55555-55555

〃

〃

〃

〃

〃

〃

〃

〃

〃

〃

〃

xxxxx-xxxxx

1 ライセ
ンス

00002-00001-00001

B01-0001

77777-77777

〃
〃
BBB シ
ステム
Ver.1

〃

66666-66666〃

12345-12345***************************************************************************

その際、クラッシュした PC 分の＜認証データテーブル＞内のレコードは、以降活用されることのな
いデッドレコードとなりますが、システム上の問題はありません。

＜認証ログテーブル＞
このテーブルには、ライセンス認証に関わる様々な処理結果がログとして 1 レコードずつ記録されます。
このテーブルの内容は、社内システムの「ログの表示」処理で確認、また必要に応じて削除することができます。
＜認証ログテーブルの例＞「認証レスキュー！.NET」 ユーザーズガイド- 376 -

・自動 No.
レコード追加時に自動的に付番されます。
初期値（シード）、増分（インクリメント）ともに 1 です。
・日時
ログが記録された日時です。
・処理区分
ログが書き込まれる際に、行われていた処理を示します。
・ステータスフラグ
ログが書き込まれる際に、その処理における結果状態を示します。
「処理区分」と「ステータスフラグ」の定義は次の通りです。
処理区分
1:キー作成2:キー削除3:認証登録4:認証解除

5:キー作成（自動ナンバリング）

6:キー作成（表形式）

ステータスフラグ
1:正常登録2:重複データ
3:何らかの原因
11:同時実行違反
1:正常削除
2:該当キーなし
3:何らかの原因
1:正常登録2:ライセンス超え
3:該当キーなし
4:何らかの原因
5:重複データ
1:正常解除3:該当データなし
4:何らかの原因
1:正常登録2:重複データ
3:何らかの原因
11:同時実行違反
1:正常登録2:重複データ
3:何らかの原因
11:同時実行違反「認証レスキュー！.NET」 ユーザーズガイド- 377 -

7:キー編集（表形式）

8:キー削除（選択削除）
9:キー削除（全行削除）
10:クラッシュ解除

11:キー作成（インポート）

12:キー作成（ランダム生成）13：有効期限の更新

1:正常登録2:重複データ
3:何らかの原因
11:同時実行違反
1:正常削除
2:該当キーなし
3:何らかの原因
1:正常削除
2:該当キーなし
3:何らかの原因
1:正常解除2:該当データなし
3:何らかの原因
1:正常登録2:重複データ
3:何らかの原因
11:同時実行違反
1:正常登録2:重複データ
3:何らかの原因
11:同時実行違反
1:正常更新・メモ
認証キー編集時の検索条件や認証登録時の有効期限などさまざまな情報を記録します。
・MAC アドレス
認証 UI ライブラリ（DLL）の UseMacAddress プロパティ、または APIUseMacAddress プロパティ
が True に設定されている場合、ログが書き込まれる際に、エンドユーザ PC の MAC アドレスを最大で 5 個記録します。
MAC アドレスは LAN ポートなどのネットワーク機器に固有な物理アドレスです。これを利用することでエンドユーザ PC の不正利用時の認証識別情報の精度を上げます。
・CPU 情報
認証 UI ライブラリ（DLL）の UseCpuInfo プロパティ、または APIUseCpuInfo プロパティが Trueに設定されている場合、ログが書き込まれる際に、エンドユーザ PC の CPU 情報を記録します。
これを利用することでエンドユーザ PC の不正利用時の認証識別情報の精度を上げます。
・IP アドレスログが書き込まれる際にエンドユーザ PC 側の（グローバル）IP アドレスを記録します。
なお、ローカル PC で Web サービスを実行している場合などの localhost を表す IP アドレスは、
IPv4 で"127.0.0.1"、IPv6 で"::1"が記録されます。
・PC 名
エンドユーザ PC の PC 名が記録されます。

「認証レスキュー！.NET」 ユーザーズガイド- 378 -

●アプリケーション難読化の必要性
ここでは、貴社が考慮するべき大変重要な事項について記載いたします。
それは、.NET アプリケーションの難読化の必要性です。
.NET 用に作成したアプリケーションのアセンブリ（.EXE や.DLL など）は、中間言語（IL）で作成されているので、簡単にリバースエンジニアリングをされてしまいます。
.NET アプリケーションの逆コンパイルは、無償の逆コンパイラなどを利用していとも簡単に実行できます。逆コンパイルにより、単にコードの内容を知られるだけにとどまらず、パスワードなどのログイ
ン情報や暗号化情報などの文字列も明らかになります。これらを放置するとその危険性がシステム全体におよび、貴社のソフトウェアビジネスに大きな損害を与えかねません。
これらのことは「認証レスキュー！」に関わらず一般的な問題なのですが、「認証レスキュー！」の場
合を考えてみます。
最終的にエンドユーザに配布されるのは「認証レスキュー！」で提供される認証 UI ライブラリ（DLL）とそれを利用して作成した貴社のアプリケーションです。
この内、認証 UI ライブラリ（DLL）は難読化を施した上で弊社（ニュートン）より出荷されています。
しかし、貴社のアプリケーションが Visual Basic（.NET)や C#で作成された場合は貴社サイドで難読化が必要となります。
貴社のアプリケーションを難読化すれば、悪意を持ったエンドユーザ（または第三者）が逆コンパイ
ルしてもパスワードなどのログイン情報や暗号化情報などが露呈することはありません。
不正逆コンパイル対策のために弊社の難読化ツールなどで.NET アプリケーションを「難読化」されることを強く推奨いたします。
「難読化ツール」の詳細につきましては、弊社の「Spices.NET JP」Web サイトをご覧ください。

「認証レスキュー！.NET」 ユーザーズガイド- 379 -

「認証レスキュー！.NET」ユーザーズガイド （3.0.2）2024 年 4 月 10 日 初版発行
2024 年 5 月 30 日 第 2 版発行
2024 年 9 月 6 日 第 3 版発行

著者
株式会社ニュートン
発行所 株式会社ニュートン
新潟県長岡市本町 2-2-15 シャングリラ本町 1F
www.newtone.co.jp
Copyright Ⓒ Newtone Corporation
本書は、法律に定めのある場合または権利者の承諾のある場合を除いて、いかなる方法においても複製・複写することはできません。

「認証レスキュー！.NET」 ユーザーズガイド- 380 -