lineGetCountry 関数 (tapi.h)
lineGetCountry 関数は、指定した国/地域、国/地域リストの最初の国/地域、またはすべての国/地域に関連する、格納されているダイヤル ルールおよびその他の情報をフェッチします。
構文
LONG lineGetCountry(
DWORD dwCountryID,
DWORD dwAPIVersion,
LPLINECOUNTRYLIST lpLineCountryList
);
パラメーター
dwCountryID
情報を取得する国/地域の国/地域識別子 (国コードではありません)。 値 1 を指定すると、国/地域リストの最初の国/地域に関する情報が取得されます。 値 0 を指定すると、すべての国/地域に関する情報が取得されます (大量のメモリが必要になる可能性があります —20 KB 以上)。
dwAPIVersion
アプリケーションでサポートされている TAPI の最高バージョン (特定の回線デバイスで lineNegotiateAPIVersion によってネゴシエートされる値とは限りません)。
lpLineCountryList
LINECOUNTRYLIST 構造体が読み込まれる場所へのポインター。 lineGetCountry を呼び出す前に、アプリケーションは、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示す必要があります。
メモ 構造体のサイズ パラメーターが正しくない場合は、データが上書きされる可能性があります。 構造体のサイズの設定の詳細については、 メモリ割り当て に関するトピックを参照してください。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INIFILECORRUPT、LINEERR_OPERATIONFAILED、LINEERR_INVALCOUNTRYCODE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tapi.h |
| Library | Tapi32.lib |
| [DLL] | Tapi32.dll |