lineGetAddressCaps 関数 (tapi.h)

[アーティクル]
03/02/2024

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。