次の方法で共有

LINELOCATIONENTRY 構造体 (tapi.h)

  • [アーティクル]

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 メンバーとサイズを使用する必要があります。

要件

要件 値
Header tapi.h

こちらもご覧ください

LINETRANSLATECAPS

lineGetCountry

lineGetTranslateCaps

lineTranslateAddress