HOME  |  SLIDE EDITOR  |  DONGLE MASTER  |  VOICE TRAINER  |  KAEDE CMS  |  CONTACT  |  BBS  | 

ドングルマスター

ドングルのチェック(VB.NET編)

作成したドングルを利用するには、使用するプログラムの中からドングルのチェックが行えるようにしなければなりません。このためにドングルマスターではのクラスライブラリを提供しています。ドングルのチェックはクラスライブラリの中のたった一つのメソッドを実行するだけで行えます。

クラスライブラリ

ドングルのチェックに必要なメソッド等はドングルマスターが提供するクラスライブラリに含まれています。クラスライブラリの名前はDongle.dllで、ドングルマスターのインストールフォルダ(既定ではProgram Files/Dongle)の中にあります。
クラスライブラリは.NET用に作られていますので、C#,VB,Delphi.NETなどの.NET対応のプログラムから利用することができます。
このクラスライブラリは自由に配布することができます。

このページのトップへ PageTop

検証用メソッド

VBのプログラムからドングルの検証を行うには、DongleUtilityクラス(Dongle名前空間)の静的なVerifyDongleメソッドを使用します。VerifyDongleメソッドは挿入されているすべてのUSBメモリーをチェックして、正しいドングルが挿入されているかどうかを検証します。VerifyDongleメソッドの構文は次のとおりです。

構文

名前空間Dongle
クラスDongleUtility

Public Shared Function VerifyDongle(publicKey As String, authFileName As String) As VerifyInfo

パラメータ

publicKey認証ファイル中のシリアル番号を復号化するための公開キーです。公開キーはドングルマスターにより自動的に生成されるものを使用します。
authFileName認証ファイルの名前です。パスは不要です。認証ファイル名はドングルマスターにより自動的に生成されるものを使用します。

戻り値

検証情報クラスVerifyInfoのインスタンスを返します。

検証情報クラス

検証情報クラスVerifyInfo(Dongle名前空間)は次のように定義されています。

Public Class VerifyInfo

 Public VerifyState As VerifyState検証結果
 Public Message As String検証結果メッセージ
 Public DriveName As Stringドライブ名
 Public SerialNum As Stringシリアル番号
 Public Options As Stringオプション情報

End Class

検証結果列挙体

検証結果としては次のような列挙体VerifyState(Dongle名前空間)の列挙型の値を返します。列挙体VerifyStateは次のように定義されています。

Public Enum VerifyState

 NONE未実行
 NO_USBUSBメモリーが挿入されていません
 NO_SELECTED_USBドングルにするデバイスが選択されていません
 FAILED_CREATEドングルの作成に失敗しました
 CREATEDドングルが作成されました
 NO_AUTHFILE認証ファイルがありません
 INVALID_AUTHFILE認証ファイルの内容が正しくありません
 AUTHENTICATED正しく認証しました
 NO_SERIAL_NUMBERUSBのシリアル番号が入力されていません
 NO_PUBLISH_FOLDER認証ファイルの発行場所が設定されていません
 FAILED_PUBLISH認証ファイルの発行に失敗しました
 PUBLISHED認証ファイルが発行されました

End Enum

このページのトップへ PageTop

プログラムサンプル

ここではボタンを押すとドングルの検証を行う簡単なプログラムを作成します。

VBプロジェクトの作成

VisualStudioを起動しVBWindowsアプリケーション用のプロジェクトを作成します。

参照の追加

ドングルの検証にはクラスライブラリDongle.dllを使用しますので、Dongle.dllへの参照をプロジェクトに追加する必要があります。
Visual Studio .NETではメニューの[プロジェクト]−[参照の追加]を実行して、Dongle.dllを追加します。
Dongle.dllはドングルマスターのインストールフォルダ(既定ではProgram Files/Dongle)の中にあります。

検証ボタンの追加

ドングルの検証を行うための検証ボタンを追加します。
サンプル画面

検証イベントハンドラの作成

検証ボタンのClickイベントのハンドラをプロパティウインドウから追加します。イベントハンドラには次のような処理を記述します。
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
        Handles Button1.Click
    Dim publicKey As String = "XXXX(注1)XXXX"
    Dim authFileName As String = "XXXX(注2)XXXX"
    Dim verifyInfo As Dongle.VerifyInfo = _
        Dongle.DongleUtility.VerifyDongle(publicKey, authFileName)
    If verifyInfo.VerifyState = Dongle.VerifyState.AUTHENTICATED Then
        MessageBox.Show("認証しました(^_^)")
    Else
        MessageBox.Show(verifyInfo.Message)
    End If
End Sub

(注1)ドングルマスターの画面より[公開キーのコピー]ボタンでコピーして張り付けます。

(注2)ドングルマスターの画面より[ファイル名のコピー]ボタンでコピーして張り付けます。

ビルドと実行

プロジェクトをビルドしてプログラムを実行します。
正しいドングルを挿入してボタンを押すと「認証しました(^_^)」と表示されます。ドングルを入れない場合、別のUSBメモリーを入れた場合、ドングル内の認証ファイルの内容を改竄した場合など確認して下さい。状況に応じたメッセージが表示されます。

(注意)試用版のドングルマスターで作成したドングルは認証時に「このプロテクトドングルは ドングルマスター(試用版) で作成されました」のメッセージが表示されます。

このページのトップへ PageTop