■テレディア用DLL(ダイナミックリンクライブラリ)の仕様

□名称
----------------------------------------------------------
TeleDir.Dll


□使用プラットホーム
----------------------------------------------------------
Microsoft Windows95,98 または Microsoft WindowsNT4.0


□参照レジストリ値
----------------------------------------------------------
場所	HKEY_USERS\Software\COMON\TeleDir
値	Data Path= データフォルダへのフルパス
	値がない場合は、カレントフォルダ


□実行時に必要なファイル
----------------------------------------------------------
DLLカレントフォルダに必要なファイル
----------------------------------------------------------
Add_Idx.tbl
Block.tbl
C_Tel.tbl
P_Tel.tbl
Tel_Area.idx


□都道府県コード一覧表
----------------------------------------------------------
北海道		01
青森県		02
岩手県		03
宮城県		04
秋田県		05
山形県		06
福島県		07
茨城県		08
栃木県		09
群馬県		10
埼玉県		11
千葉県		12
東京都		13
神奈川県	14
新潟県		15
富山県		16
石川県		17
福井県		18
山梨県		19
長野県		20
岐阜県		21
静岡県		22
愛知県		23
三重県		24
滋賀県		25
京都府		26
大阪府		27
兵庫県		28
奈良県		29
和歌山県	30
鳥取県		31
島根県		32
岡山県		33
広島県		34
山口県		35
徳島県		36
香川県		37
愛媛県		38
高知県		39
福岡県		40
佐賀県		41
長崎県		42
熊本県		43
大分県		44
宮崎県		45
鹿児島県	46
沖縄県		47


□エクスポート関数リファレンス
----------------------------------------------------------
int GetPref(LPSTR pAddName)
----------------------------------------------------------
○説明	都道府県名を得る

○引数	pAddName	AddName のアドレスを指定

・AddName の構造	unsigned char [200][30] AddName

○戻値	都道府県数を返す(現在は47)

----------------------------------------------------------
int GetCity(unsigned char Pref, LPSTR pAddName)
----------------------------------------------------------
○説明	区市郡名を得る

○引数	Pref		GetPref で得た都道府県コード
	pAddName	AddName のアドレスを指定

○戻値	区市郡数を返す

----------------------------------------------------------
int GetTown(unsigned char City, LPSTR pAddName)
----------------------------------------------------------
○説明	区町村名を得る

○引数	City		GetCity で得た区市郡コード
	pAddName	AddName のアドレスを指定

○戻値	区町村数を返す

○備考	この関数を呼び出す前に必ず GetCity を呼び出す必要がある
	(GetCity で得るべき区町村の都道府県を特定するため)

	政令指定都市以外の市は区町村名は返さない。
	また、東京23区は町名を返す。

----------------------------------------------------------
int TDTelCall(LPSTR pTelIn, LPSTR pOutRec)
----------------------------------------------------------
○説明	電話番号検索を実行する

○引数	pTelIn		TELIN 構造体のアドレスを指定
	pOutRec		OUTREC 構造体のアドレスを指定

・TELIN 構造体(15 Bytes)

電話番号	unsigned char	12
シリアル番号	unsigned char	 3

・OUTREC 構造体(270 Bytes)

電話番号	unsigned char	12
名称		unsigned char	80
郵便番号	unsigned char	 8
都道府県名	unsigned char	10
区市郡名	unsigned char	30
区町村名	unsigned char	30
その他住所	unsigned char	70
番地		unsigned char	30

○戻値	以下の検索結果ステータスを返す

 0	正常終了
 1	検索不可で近隣地区を返した場合
 2	検索不可で近隣地区を返せない場合
 3	TELIN 構造体の値設定エラー
 8	CD-ROMの種別が一致しない場合
 9	正しくCD-ROMのパスを指定してない場合
	(参照レジストリ値を参照)

○備考

・TELIN 構造体について

電話番号はASCII文字でハイフォン等はあっても可(無視される)

シリアル番号に 000 または 001 を指定すると、同一電話番号の
最初のデータが結果として OUTREC 構造体に返される。検索でき
なかった場合、近隣地区を返すことが可能なら返す。

シリアル番号に 002 以降の番号を指定すると、同一電話番号の
データの中で指定した番目のデータが返される。検索できなかっ
た場合でも、近隣地区は常に返さない

・近隣地区について

指定した電話番号が検索できなかった場合、その前後の電話番号
の住所を近隣地区として OUTREC 構造体の一部として返し、検索
結果ステータスに 1 を返す。

近隣地区が1個所の場合、OUTREC 構造体の「都道府県」「区市郡」
「区町村」にそれぞれ格納される。

近隣地区が2個所の場合、上記に加え「その他住所」に、都道府県
+区市郡+区町村が一括して格納される。

----------------------------------------------------------
int TDNameStart(LPSTR pNameIn)
----------------------------------------------------------
○説明	名称検索を開始する

○引数	pNameIn		NAMEIN 構造体のアドレスを指定

・NAMEIN 構造体(139 Bytes)

出力ファイル	unsigned char	50
住所コード	unsigned char	 7
名称		unsigned char	80
検索方法	unsigned char	 1
出力形式	unsigned char	 1

○戻値	以下の検索結果ステータスを返す

 1	正常終了−1件出力
 0	正常終了−出力はなし
-1	NAMEIN 構造体の値設定エラー
-2	ファイル入出力エラー
-8	CD-ROMの種別が一致しない場合
-9	正しくCD-ROMのパスを指定してない場合
	(参照レジストリ値を参照)

○備考

この関数は、後述の TDNameNext、TDNameEnd 両関数とセットで使用し、
最初にこの関数を呼び出した後、TDNameNext 関数を適宜繰り返し呼び
出し、最後に TDNameEnd 関数を呼び出して一連の処理を終える。

・NAMEIN 構造体について

「出力ファイル」は、書出すテキストファイルをフルパスで指定する。

「住所コード」は、上位2桁が都道府県コード、次の3桁が区市郡コ
ード、下位2桁が区町村コード。都道府県コードと区市郡コードは、
必ず必要で、区町村コードはなくとも可。その場合 00 で埋める。

「名称」は検索方法の如何に関係なく漢字2文字以上必要。
なお、個人名の姓と名の間には必ず全角空白が必要。

「検索方法」は 1 が前方一致検索で 2 が部分一致検索。

「出力形式」は 1 が固定長テキストで 2 がCSV形式。出力項目の
順序と大きさは OUTREC 構造体と同じ。
なお、出力先の空き容量はチェックしないので要注意。

----------------------------------------------------------
int TDNameNext
----------------------------------------------------------
○説明	名称検索を続行する

○引数	なし

○戻値	以下の検索結果ステータスを返す

 0-n	正常終了−現在の出力済み件数
-1	検索正常終了
-2	実行不可エラー

○備考

この関数の使用を始める前に、まず最初に TDNameStart 関数を1回
だけ呼び出す必要があり、その戻値に 0 または 1 が返ってこなけ
ればならない。

この関数は、1回呼び出す毎に、1件のデータを処理し、そのデータ
が条件に一致していれば出力ファイルに書き出す。したがって、戻値
に -1 を返すまで連続して繰り返し呼び出して使用する。

----------------------------------------------------------
int TDNameEnd
----------------------------------------------------------
○説明	名称検索を終了または中断する

○引数	なし

○戻値	以下の検索結果ステータスを返す

 0-n	正常終了−合計出力件数
-1	実行不可エラー

○備考

この関数を呼び出すには、最低でも TDNameStart 関数の呼び出しが
必要。ただし、TDNameNext 関数を1度も呼び出していなくとも可。
また、TDNameNext 関数により、検索正常終了ステータス(-1)を得て
いなくとも、この関数を呼び出して一連の処理を中断終了できる。

なお、TDNameStart 関数を呼び出したら、必ずこの関数を呼び出し、
一連の処理を終了しておく必要がある。一連の処理を終了する前に
2度目の TDNameStart 関数を呼び出してはならない。


□DLLの著作権者
----------------------------------------------------------
有限会社コモンルミネクス
Copyright (C) COMON Lumineux Co.,Ltd. 1999


□注意事項
----------------------------------------------------------
・このDLLは、添付されていたテレディア製品CD-ROMに対して
のみ使用を許可する。
・このDLLは、同時に複数台のパソコンで使用してはならない。
・このDLLは、Microsoft Visual Basic Version 5.0J または、
Borland Delphi Version 4.0J での使用を前提としており、その他の
開発言語での動作は保証しない。
・このDLLに対して、一切の改変及び解析等を行ってはならない。
・このDLLの使用にあたって生じたいかなる損害等についても著作
権者は賠償の責を負わない。
・このDLLの仕様等については予告なく変更することがある。


※各社のブランドおよび製品名は、その版権所有者の商標または登録商標です。