LINELOCATIONENTRY 構造体 (tapi.h)

[アーティクル]
08/26/2023

LINELOCATIONENTRY 構造体は、アドレス変換コンテキストを提供するために使用される場所を表します。 LINETRANSLATECAPS 構造体には、LINELOCATIONENTRY 構造体の配列を含めることができます。

構文

typedef struct linelocationentry_tag {
  DWORD dwPermanentLocationID;
  DWORD dwLocationNameSize;
  DWORD dwLocationNameOffset;
  DWORD dwCountryCode;
  DWORD dwCityCodeSize;
  DWORD dwCityCodeOffset;
  DWORD dwPreferredCardID;
  DWORD dwLocalAccessCodeSize;
  DWORD dwLocalAccessCodeOffset;
  DWORD dwLongDistanceAccessCodeSize;
  DWORD dwLongDistanceAccessCodeOffset;
  DWORD dwTollPrefixListSize;
  DWORD dwTollPrefixListOffset;
  DWORD dwCountryID;
  DWORD dwOptions;
  DWORD dwCancelCallWaitingSize;
  DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;

メンバー

dwPermanentLocationID

永久。場所を識別します。

dwLocationNameSize

null で終わる文字を含む null で終わる場所名 文字列のサイズ (文字単位)。

dwLocationNameOffset

(このエントリを含む) LINETRANSLATECAPS 構造体の先頭から、ユーザーフレンドリな方法で場所を記述する null で終わる文字列までのオフセットサイズを dwLocationNameSize で指定します。

dwCountryCode

場所の国または地域コード。

dwCityCodeSize

null 終端文字を含む、 null で終わる都市コード 文字列のサイズ (文字単位)。

dwCityCodeOffset

この構造体の先頭から、場所に関連付けられている市区町村コードを指定する null で終わる文字列に、dwCityCodeSize で指定されたオフセット。この情報は、国または地域のコードと共に、適切な正規番号の入力を促すために、電話番号を入力するときにユーザーの "既定の" エントリフィールドにアプリケーションで使用できます。

dwPreferredCardID

この場所からダイヤルする場合は、カードを呼び出すのが推奨されます。

dwLocalAccessCodeSize

null 終端記号を含むローカルアクセスコード文字列のサイズ (バイト単位)。

dwLocalAccessCodeOffset

DWLocalAccessCodeSize で指定されたオフセットサイズ。LINETRANSLATECAPS 構造体の先頭から、ローカル呼び出し元領域のアドレスを呼び出す前にダイヤルされるアクセスコードを含む null で終わる文字列まで。

dwLongDistanceAccessCodeSize

null 終端記号を含む、長距離アクセスコードのサイズ (バイト単位)。

dwLongDistanceAccessCodeOffset

dwLongDistanceAccessCodeSize で指定されたオフセットサイズ。LINETRANSLATECAPS 構造体の先頭から、ローカル呼び出し領域外のアドレスを呼び出す前にダイヤルされるアクセスコードを含む null で終わる文字列まで。

dwTollPrefixListSize

null 終端記号を含む有料プレフィックスのサイズ (バイト単位)。

dwTollPrefixListOffset

LINETRANSLATECAPS 構造体の先頭から、場所の有料プレフィックスリストを含む null で終わる文字列までのオフセットサイズを dwTollPrefixListSize で指定します。文字列には、"0" から "9" までの数字で構成されるプレフィックスのみが含まれます。1 つの "," (コンマ) 文字で区切られます。

dwCountryID

場所に対して選択された国/地域の識別子。これは lineGetCountry 関数と共に使用して、国/地域名などの特定の国/地域に関する追加情報を取得できます (国/地域コードは一意ではないので、 dwCountryCode メンバーをこの目的に使用することはできません)。

dwOptions

LINELOCATIONOPTION_定数から取得された値を使用して、この場所に有効なオプション。

dwCancelCallWaitingSize

cancel-call-waiting 文字列のサイズ (バイト単位)。

dwCancelCallWaitingOffset

LINETRANSLATECAPS 構造体の先頭から、lineTranslateAddress の dwTranslateOptions パラメーターでLINETRANSLATEOPTION_CANCELCALLWAITINGビットを設定するときに、ダイヤル可能な文字列 (パルス/トーン文字の後) にプレフィックスを付ける必要があるダイヤル数字と修飾子文字を含む null で終わる文字列に、dwCancelCallWaitingSize で指定されたオフセットサイズ。プレフィックスが定義されていない場合、 dwCancelCallWaitingSize は 0 または 1 に設定され、 dwCancelCallWaitingOffset は空の文字列 (1 つの NULL バイト) を指している可能性があります。

注釈

この構造体を拡張することはできません。

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