4.4.2 ActiveXコンポーネントの作成

外部ユーザ認証用のActiveXコンポーネントの基本仕様を次に示します。

オブジェクト名
任意の名称
メソッド
次に示す二つのメソッドを使用します。各メソッドには,それぞれ固有のプロパティ情報があります。メソッドとプロパティの名称は変更できません。
  • ユーザ認証メソッド(hs5um_OutSideAuthenticate)
  • グループ一覧取得メソッド(hs5um_OutSideGetGroupList)
注意
すべての機能をサポートする必要はありませんが,ダミーとしてでもよいので,すべてのメソッド及びプロパティを実装してください。
<この項の構成>
(1) ユーザ認証メソッド(hs5um_OutSideAuthenticate)
(2) グループ一覧取得メソッド(hs5um_OutSideGetGroupList)

(1) ユーザ認証メソッド(hs5um_OutSideAuthenticate)

(a) 機能

指定したモードに従い,ユーザ情報を取得します。指摘できるモードを次に示します。

モード種別ユーザ情報の取得方法
2引数sLcaseUsrIDで渡したユーザIDと,引数sPasswdで渡したパスワードでユーザ認証をして,プロパティにユーザ情報を設定します。プロパティに設定されたユーザの権限でHITSENSER5 Webを実行します。
(b) 形式

hs5um_OutSideAuthenticate(iMode,sLcaseUsrID,sPasswd)〔Long〕

(c) 引数
(d) 戻り値

0以上の戻り値は実装する必要があります。エラーは例外として実装してもかまいません。戻り値1~3が返された場合は,HITSENSER5 Web側で対応するメッセージが出力されます。

戻り値説明
-1エラー(詳細エラー情報を参照のこと)。
0正常終了。
ユーザ情報(ユーザID,パスワード,ユーザ名,ユーザが持つ権限,ユーザが所属するグループ数,ユーザが所属するグループの一覧)を返します。
1指定したユーザIDが存在しません。
2指定したパスワードが不正です。
3指定したユーザID又はパスワードが不正です。
戻り値1と2を区別しない場合に使用します。
(e) 固有のプロパティ

(2) グループ一覧取得メソッド(hs5um_OutSideGetGroupList)

(a) 機能

グループの一覧を取得します。管理しているユーザが所属しているすべてのグループの一覧を取得してください。取得したグループの一覧は,分析情報ファイルを公開する対象グループを選択するときに使用されます。

グループ一覧取得メソッドは,レジストリに登録したユーザ認証モードが「OutSideMode=IDOUT(HITSENSER5 WebユーザID取得,外部ユーザ認証の場合)」ときに使用します。グループ一覧取得メソッドを使用する場合,ユーザ認証メソッドが正常に終了している必要があります。

注意
グループを作成しない場合は,グループ一覧取得メソッドを実装しないでください。
(b) 形式

hs5um_OutSideGetGroupList(iMode)〔Long〕

(c) 引数
iMode〔Long〕
ユーザ認証モードの動作モードとして「0(通常モード)」を指定します。
(d) 戻り値
戻り値説明
-1エラー(詳細エラー情報を参照のこと)。
0ダミーメソッドとして使用されています。
0以上グループ数を返します。
(e) 固有のプロパティ