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 |