LINETRANSLATEOUTPUT 構造体 (tapi.h)
LINETRANSLATEOUTPUT 構造体は、アドレス変換の結果を記述します。 lineTranslateAddress 関数は、この構造体を使用します。
構文
typedef struct linetranslateoutput_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwDialableStringSize;
DWORD dwDialableStringOffset;
DWORD dwDisplayableStringSize;
DWORD dwDisplayableStringOffset;
DWORD dwCurrentCountry;
DWORD dwDestCountry;
DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;
メンバー
dwTotalSize
このデータ構造に割り当てられた合計サイズ (バイト単位)。
dwNeededSize
返されたすべての情報をバイト単位で保持するために、このデータ構造に必要なサイズ。
dwUsedSize
有用な情報を含むこのデータ構造の部分のサイズ (バイト単位)。
dwDialableStringSize
ダイヤル可能な文字列のサイズ (終端 の NULL を含むバイト単位)。
dwDialableStringOffset
この構造体の先頭から、 lineMakeCall、 lineDial、またはダイヤル可能な文字列を必要とするその他の関数に渡すことができる変換された出力へのオフセット。 出力は常に null で終わる文字列です。 name や subaddress などの補助フィールドは、入力文字列に含まれていた場合、この出力文字列に含まれます。 この文字列には、カード番号の呼び出しなどの個人情報が含まれる場合があります。 承認されていないユーザーへの不注意な可視性を防ぐために、ユーザーに表示しないでください。 フィールドのサイズは dwDialableStringSize によって指定されます。
dwDisplayableStringSize
null ターミネータを含む、ユーザーに表示できる変換された出力のサイズ (バイト単位)。
dwDisplayableStringOffset
確認のためにユーザーに表示できる変換された出力へのオフセット。 DialableString と同じですが、呼び出し元のカード数字は角かっこ文字で囲まれたカードのフレンドリ名 (例: "[AT&T Card]") に置き換えられ、名前やサブアドレスなどの補助フィールドは削除されます。 文字列が呼び出し状態ダイアログ ボックスに公開される可能性があるため、 dwDisplayableStringOffset で適切なメッセージを使用します。 この情報は、呼び出しログに含めるのにも適しています。 フィールドのサイズは dwDisplayableStringSize によって指定されます。
dwCurrentCountry
CurrentLocation で構成された国または地域コード。 この値は、特定のユーザー インターフェイス要素のアプリケーション、ローカル通話の進行状況トーン検出、およびその他の目的で表示を制御するために使用できます。
dwDestCountry
翻訳された住所の宛先の国/地域コード。 この値は、lineMakeCall およびその他のダイヤル機能の dwCountryCode パラメーターに渡すことができます (ビジー信号などの宛先国/地域の通話進行状況トーンが適切に検出されるようにします)。 lineTranslateAddress に渡される宛先アドレスが正規形式でない場合、このフィールドは 0 に設定されます。
dwTranslateResults
翻訳プロセスから派生した情報。これは、アプリケーションがユーザー インターフェイス要素を提示する際に役立つ場合があります。 このフィールドでは、 LINETRANSLATERESULT_定数のいずれかを使用します。
注釈
この構造体を拡張することはできません。
要件
| 要件 | 値 |
|---|---|
| Header | tapi.h |