tapiRequestMakeCall 関数は、音声呼び出しの確立を要求します。 呼び出しマネージャー アプリケーションは、要求元アプリケーションに代わって呼び出しを確立する役割を担います。この呼び出しは、ユーザーの call-manager アプリケーションによって制御されます。
構文
LONG tapiRequestMakeCallA(
LPCSTR lpszDestAddress,
LPCSTR lpszAppName,
LPCSTR lpszCalledParty,
LPCSTR lpszComment
);
パラメーター
lpszDestAddress
呼び出し要求の null終了宛先アドレスが配置されているメモリ位置へのポインター。 アドレスは、正規アドレス 形式を使用できます。 指定したアドレスの有効性は、この操作ではチェックされません。 アドレスの最大長は TAPIMAXDESTADDRESSSIZE 文字で、NULL ターミネータが含まれます。
lpszAppName
呼び出し要求の null終了したわかりやすいアプリケーション名が配置されているメモリ位置へのポインター。 アプリケーションがアプリケーション名 指定しない場合、このポインターは NULL のままにすることができます。 アドレスの最大長は TAPIMAXAPPNAMESIZE 文字で、NULL ターミネータが含まれます。 長い文字列は切り捨てられます。
lpszCalledParty
呼び出しの呼び出し先の呼び出し先の null終了した呼び出し側名が配置されているメモリ位置へのポインター。 アプリケーションがこの情報を提供したくない場合は、このポインターを NULL
lpszComment
呼び出しに関する null終了コメントがあるメモリ位置へのポインター。 アプリケーションがコメント 指定しない場合、このポインターは NULL のままにすることができます。 アドレスの最大長は TAPIMAXCOMMENTSIZE 文字です。これには、NULL ターミネータが含まれます。 長い文字列は切り捨てられます。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 考えられるエラー戻り値は次のとおりです。
TAPIERR_NOREQUESTRECIPIENT、TAPIERR_INVALDESTADDRESS、TAPIERR_REQUESTQUEUEFULL、TAPIERR_INVALPOINTER。
備考
テレフォニー対応アプリケーションは、tapiRequestMakeCall
呼び出し制御アプリケーションが実行されていない場合 tapiRequestMakeCall を呼び出すと、TAPIERR_NOREQUESTRECIPIENTエラー表示が返されます。 呼び出し制御アプリケーションが実行されていない場合、TAPI は最も優先度の高い呼び出し制御アプリケーションの起動を試みます (レジストリの RequestMakeCall
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして tapiRequestMakeCall を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |