linePickupA 関数 (tapi.h)

linePickup 関数は、指定した宛先アドレスで警告する呼び出しを取得し、選択された呼び出しの呼び出しハンドルを返します。 lpszDestAddress パラメーター NULL で呼び出された場合、グループピックアップが実行されます。 デバイスで必要な場合は、lpszGroupID アラート ステーションが属するグループ識別子を指定します。

構文

LONG linePickupA(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCSTR  lpszDestAddress,
  LPCSTR  lpszGroupID
);

パラメーター

hLine

呼び出しを受け取るオープンライン デバイスへのハンドル。

dwAddressID

ピックアップ 発生する hLine のアドレス。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード間で一定のままです。

lphCall

ピックアップされた呼び出しへのハンドルが返されるメモリ位置へのポインター。 アプリケーションは、呼び出しの最初の唯一の所有者です。

lpszDestAddress

呼び出しを取得するアドレスを含む、null終了文字バッファーへのポインター。 アドレスは標準のダイヤル可能なアドレス形式です。

lpszGroupID

アラート ステーションが属するグループ識別子を含む null終了文字バッファーへのポインター。 このパラメーターは、現在のピックアップ グループの外部で呼び出しを取得するために、一部のスイッチで必要です。

lpszGroupID パラメーターは、lpszDestAddressの NULL ポインター 単独で指定できます。 または、lpszGroupID 、lpszDestAddressに加えて、デバイスで必要な場合に指定することもできます。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。 対応する LINE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。 可能な戻り値は次のとおりです。

LINEERR_INVALADDRESS、LINEERR_NOMEM、LINEERR_INVALADDRESSID、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALGROUPID、LINEERR_OPERATIONFAILED、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED。

備考

呼び出しが正常に取得されると、呼び出し状態の変更に関する LINE_CALLSTATE メッセージによってアプリケーションに通知されます。 LINECALLINFO 構造体は、取得された呼び出しに関する情報を提供します。 これは、ピックアップとして呼び出しの理由 一覧表示します. この構造体は、lineGetCallInfoを使用して使用できます。

LINEADDRCAPFLAGS_PICKUPCALLWAITが TRUE場合、linePickup を使用して、ユーザーが通話待機シグナルを適切に検出したが、プロバイダーが検出を実行できない通話を取得できます。 これにより、サービス プロバイダーが呼び出し待機シグナルを検出できなかった場合でも、ユーザーは待機中の呼び出しに "応答" するメカニズムが提供されます。 lpszDestAddress lpszGroupID ポインター パラメーターはどちらも、呼び出し待機呼び出しを取得するために NULL する必要があります。 linePickup 関数は、待機中の呼び出しの新しい呼び出しハンドルを作成し、そのハンドルをユーザーに渡します。 dwAddressID パラメーターは、多くの場合 0 です (特に単一行住宅の場合)。

linePickup を使用して 2 つ目の呼び出しを取得した後、lineSwapHold 使用して切り替えることができます。 lineDrop 関数を使用して、1 つを削除したり、もう一方に切り替えることができます。 ユーザーが現在の通話を破棄して 2 番目の呼び出しを受け取る場合は、呼び出し待機中のビープ音が鳴ったときに lineDrop を呼び出し、2 回目の呼び出しが呼び出されるのを待ってから、新しい呼び出しハンドル lineAnswer を呼び出す必要があります。 dwAddressFeatures メンバー内の LINEADDRFEATURE_PICKUP フラグ LINEADDRESSSTATUS は、ピックアップが実際に可能であることを示します。

手記

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

必要条件

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

関連項目

LINEADDRESSSTATUS

LINECALLINFO

LINE_CALLSTATE

LINE_REPLY

ピックアップの概要

補助回線サービス関数

TAPI 2.2 リファレンスの概要

lineAnswer

lineDrop

lineGetCallInfo を する

lineSwapHold を する

  • Last updated on