次の方法で共有


lineGetAddressCaps 関数 (tapi.h)

lineGetAddressCaps 関数は、指定した回線デバイスの指定されたアドレスに対してクエリを実行して、テレフォニー機能を決定します。

構文

LONG lineGetAddressCaps(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

パラメーター

hLineApp

TAPI を使用してアプリケーションの登録を処理します。

dwDeviceID

クエリ対象のアドレスを含む回線デバイス。

dwAddressID

クエリを実行する機能を持つ特定の回線デバイスのアドレス。 アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティング システムのアップグレード間で一定のままです。

dwAPIVersion

使用するテレフォニー API のバージョン番号。 上位ワードにはメジャー バージョン番号が含まれています。下位の単語にはマイナー バージョン番号が含まれています。 この数値は lineNegotiateAPIVersion によって取得されます。

dwExtVersion

使用するサービス プロバイダー固有の拡張機能のバージョン番号。 デバイス固有の拡張機能を使用しない場合は、この数値を 0 に設定できます。 それ以外の場合、上位の単語にはメジャー バージョン番号が含まれます。下位ワードにはマイナー バージョン番号が含まれています。

lpAddressCaps

LINEADDRESSCAPS 型の可変サイズの構造体へのポインター。 要求が正常に完了すると、この構造体にはアドレス機能情報が入力されます。 lineGetAddressCaps を呼び出す前に、アプリケーションは、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示す必要があります。

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

戻り値

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

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONFAILED、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALAPPHANDLE、LINEERR_UNINITIALIZED、LINEERR_INVALPOINTER、LINEERR_OPERATIONUNAVAIL、LINEERR_NODRIVER、LINEERR_NODEVICE。

注釈

有効なアドレス識別子の範囲は、 lineGetDevCaps によって返されるアドレスの数より 0 から 1 未満です。 指定するバージョン番号は、 lineGetDevCaps によって行のデバイス機能の一部として返されたバージョン番号です。

要件

要件
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

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

LINEADDRESSCAPS

TAPI 2.2 リファレンスの概要

lineGetDevCaps

lineNegotiateAPIVersion