次の方法で共有


lineGetTranslateCapsW 関数 (tapi.h)

lineGetTranslateCaps 関数は、アドレス変換機能を返します。

構文

LONG lineGetTranslateCapsW(
  HLINEAPP            hLineApp,
  DWORD               dwAPIVersion,
  LPLINETRANSLATECAPS lpTranslateCaps
);

パラメーター

hLineApp

lineInitializeEx 関数によって返されるハンドル。 アプリケーションが lineInitializeEx 関数をまだ呼び出していない場合、このパラメーターは 0 にすることができます。

注意 TAPI 1.4 アプリケーションでは、lineInitialize 関数によって返される有効な hLineApp ハンドルにこのパラメーターを設定する必要があります。
 

dwAPIVersion

アプリケーションでサポートされている TAPI の最上位バージョン (特定の回線デバイスで lineNegotiateAPIVersion によってネゴシエートされる値であるとは限りません)。

lpTranslateCaps

LINETRANSLATECAPS 構造体が読み込まれる場所へのポインター。 lineGetTranslateCaps呼び出す前に、アプリケーションはこの構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示す必要があります。

構造体のサイズ パラメーターが正しくない場合、データが上書きされる可能性があります。 構造体サイズの設定の詳細については、メモリ割り当て トピックを参照してください。
 

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INIFILECORRUPT、LINEERR_OPERATIONFAILED、LINEERR_INVALAPPHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NODRIVER。

備考

手記

tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineGetTranslateCaps を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー tapi.h
ライブラリ Tapi32.lib
DLL Tapi32.dll

関連項目

基本的なテレフォニー サービス リファレンス

LINETRANSLATECAPS

TAPI 2.2 リファレンスの概要

lineInitializeEx を する

lineNegotiateAPIVersion