lineGetAddressStatus 関数 (tapi.h)

  • [アーティクル]

lineGetAddressStatus 関数を使用すると、アプリケーションは、指定したアドレスの現在の状態を照会できます。

構文

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

パラメーター

hLine

開線デバイスへのハンドル。

dwAddressID

指定されたオープンライン デバイスのアドレス。 これはクエリを実行するアドレスです。 アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティング システムのアップグレード間で一定のままです。

lpAddressStatus

LINEADDRESSSTATUS 型の可変サイズのデータ構造へのポインター。 lineGetAddressStatus を呼び出す前に、アプリケーションは、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示す必要があります。

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

戻り値

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

LINEERR_INVALADDRESSID、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM、LINEERR_OPERATIONUNAVAIL、LINEERR_OPERATIONFAILED。

要件

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

こちらもご覧ください

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

LINEADDRESSSTATUS

TAPI 2.2 リファレンスの概要