tapiRequestMakeCall 関数 (tapi.h)

tapiRequestMakeCall 関数は、音声呼び出しの確立を要求します。 呼び出しマネージャー アプリケーションは、要求元のアプリケーションに代わって呼び出しを確立する役割を担います。この呼び出しは、ユーザーの call-manager アプリケーションによって制御されます。

構文

LONG tapiRequestMakeCall(
  LPCSTR lpszDestAddress,
  LPCSTR lpszAppName,
  LPCSTR lpszCalledParty,
  LPCSTR lpszComment
);

パラメーター

lpszDestAddress

呼び出し要求の null で終わる宛先アドレスがあるメモリの場所へのポインター。 アドレスは 正規のアドレス 形式を使用できます。 指定したアドレスの有効性は、この操作ではチェックされません。 アドレスの最大長は TAPIMAXDESTADDRESSSIZE 文字で、 NULL ターミネータが含まれます。

lpszAppName

呼び出し要求の null で終わるわかりやすいアプリケーション名があるメモリの場所へのポインター。 アプリケーションがアプリケーション名を指定しない場合は、このポインターを NULL のままに することができます。 アドレスの最大長は TAPIMAXAPPNAMESIZE 文字で、 NULL ターミネータが含まれます。 これより長い文字列は切り詰められます。

lpszCalledParty

呼び出しの呼び出し側の null で終わる呼び出し側名があるメモリの場所へのポインター。 アプリケーションがこの情報を提供しない場合は、このポインターを NULL のままに することができます。 文字列の最大長は TAPIMAXCALLEDPARTYSIZE 文字で、 NULL 終端記号が含まれます。 これより長い文字列は切り詰められます。

lpszComment

呼び出しに関する null で終わるコメントがあるメモリの場所へのポインター。 アプリケーションがコメントを指定しない場合は、このポインターを NULL のままに することができます。 アドレスの最大長は TAPIMAXCOMMENTSIZE 文字で、 NULL ターミネータが含まれます。 これより長い文字列は切り詰められます。

戻り値

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

TAPIERR_NOREQUESTRECIPIENT、TAPIERR_INVALDESTADDRESS、TAPIERR_REQUESTQUEUEFULL、TAPIERR_INVALPOINTER。

注釈

テレフォニー対応アプリケーションは、 tapiRequestMakeCall を呼び出し、呼び出しの宛先アドレスのみを指定することで、その代わりに通話を発信することを要求できます。 この要求は、元のアプリケーションの代わりに呼び出しを行うユーザーの呼び出し制御アプリケーションに転送されます。 テレフォニーの一部として、既定の呼び出し制御アプリケーションが提供されます。 ユーザーはこれを、任意の呼び出し制御アプリケーションに置き換えることができます。

呼び出し制御アプリケーションが実行されていないときに tapiRequestMakeCall を呼び出すと、TAPIERR_NOREQUESTRECIPIENTエラー表示が返されます。 呼び出し制御アプリケーションが実行されていない場合、TAPI は最も優先度の高い呼び出し制御アプリケーション (レジストリの RequestMakeCall に関する一覧) を起動しようとします。 Assisted TAPI 要求キューがいっぱいになったときにこの関数を呼び出すと、TAPIERR_REQUESTQUEUEFULL エラーが返されます。

要件

こちらもご覧ください

支援テレフォニー サービス リファレンス

TAPI 2.2 リファレンスの概要