LINECARDENTRY 構造体 (tapi.h)

LINECARDENTRY 構造体は、呼び出し元のカードを記述します。 LINETRANSLATECAPS 構造体には、LINECARDENTRY 構造体の配列を含めることができます。

構文

typedef struct linecardentry_tag {
  DWORD dwPermanentCardID;
  DWORD dwCardNameSize;
  DWORD dwCardNameOffset;
  DWORD dwCardNumberDigits;
  DWORD dwSameAreaRuleSize;
  DWORD dwSameAreaRuleOffset;
  DWORD dwLongDistanceRuleSize;
  DWORD dwLongDistanceRuleOffset;
  DWORD dwInternationalRuleSize;
  DWORD dwInternationalRuleOffset;
  DWORD dwOptions;
} LINECARDENTRY, *LPLINECARDENTRY;

メンバー

dwPermanentCardID

カードを識別する永続的な識別子。

dwCardNameSize

null 終端記号を含むカード名文字列のサイズ (バイト単位)。

dwCardNameOffset

構造体の先頭から、ユーザー フレンドリな方法でカードを記述する null で終わる文字列へのオフセット。 フィールドのサイズは dwCardNameSize で指定します。

dwCardNumberDigits

既存のカード番号の桁数。 カード番号自体は、セキュリティ上の理由から返されません (TAPI によってスクランブル形式で格納されます)。 アプリケーションは、これを使用して、"パスワード" モードのテキスト コントロールに入力者のバイトを挿入して、数値が存在することを示すことができます。

dwSameAreaRuleSize

null 終端記号を含む同一エリア ダイヤル規則のサイズ (バイト単位)。

dwSameAreaRuleOffset

LINETRANSLATECAPS 構造体の先頭から、同じエリア コード内の番号の呼び出しに対して定義されているダイヤルルールまでのオフセット。 ルールは null で終わる文字列です。 フィールドのサイズは dwSameAreaRuleSize によって指定されます。

dwLongDistanceRuleSize

null 終端記号を含む長距離ダイヤル規則のサイズ (バイト単位)。

dwLongDistanceRuleOffset

構造体の先頭から、同じ国/地域の他の地域の番号への呼び出しに対して定義されたダイヤル ルールへのオフセット。 ルールは null で終わる文字列です。 フィールドのサイズは dwLongDistanceRuleSize によって指定されます。

dwInternationalRuleSize

null 終端記号を含む国際ダイヤル規則のサイズ (バイト単位)。

dwInternationalRuleOffset

構造体の先頭から、他の国/地域の番号への呼び出しに対して定義されているダイヤルルールへのオフセット。 ルールは null で終わる文字列です。 フィールドのサイズは dwInternationalRuleSize によって指定されます。

dwOptions

LINECARDOPTION_定数を使用して、この呼び出し元のカードに関連付けられている他の設定を示します。

注釈

古いアプリケーションは、これらの新しいフィールドを知らずにコンパイルされ、新しいサイズよりも小さい SIZEOF(LINECARDENTRY) を使用します。 これは LINETRANSLATECAPS 構造体の変数部分の配列であるため、古いアプリケーションは、以前に想定した形式で LINECARDENTRY 構造体を受け取るか、配列を介して適切にインデックスを作成できないことが不可欠です。 アプリケーションは、lineGetTranslateCaps 関数を使用して dwAPIVersion パラメーターを渡します。これは、この状況を処理する TAPI によるガイダンスに使用できます。 lineGetTranslateCaps 関数は、アプリケーションに返される LINETRANSLATECAPS 構造体を構築するときに、指定された API バージョンに一致する LINECARDENTRY フィールドとサイズを使用する必要があります。

この構造体は拡張できません。

要件

要件	値
Header	tapi.h

こちらもご覧ください

LINETRANSLATECAPS

lineGetTranslateCaps