lineGetRequest 関数は、指定された要求モードの次のプロキシによる要求を取得します。
構文
LONG lineGetRequestA(
HLINEAPP hLineApp,
DWORD dwRequestMode,
LPVOID lpRequestBuffer
);
パラメーター
hLineApp
TAPI の行部分のアプリケーション使用ハンドル。
dwRequestMode
取得する要求の種類。 dwRequestMode
lpRequestBuffer
要求のパラメーターが配置されるメモリ バッファーへのポインター。 バッファーのサイズとバッファーに配置されるデータの解釈は、要求モードによって異なります。 アプリケーション割り当てバッファーは、要求を保持するのに十分なサイズであると見なされます。
dwRequestMode
LINEREQUESTMODE_MEDIACALLは廃止されています。 詳細については、「tapiRequestMediaCall」を参照してください。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
LINEERR_INVALAPPHANDLE, LINEERR_NOTREGISTERED, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOREQUEST.
備考
テレフォニー対応アプリケーションは、tapiRequestMakeCallを呼び出すことによって、その代わりに呼び出し
次に、このメッセージを受信する呼び出し制御アプリケーションは、lineGetRequestを呼び出し、要求モードと、要求を保持するのに十分な大きさのバッファーを指定します。 その後、呼び出し制御アプリケーションは要求を解釈して実行します。
lineGetRequestの実行後、TAPI は内部キューから要求を消去し、後続の要求で空き時間を利用できるようにします。 したがって、同じアプリケーションまたは別のアプリケーションが別の要求を発行した場合、lineGetRequestの実行時に、新しい LINE_REQUEST メッセージをすぐに受信できます。 このシナリオを何らかのメカニズムで処理するのは、要求受信者アプリケーションの責任です。たとえば、追加のLINE_REQUESTに従い、前の要求の処理が完了するまで、または必要に応じて後続の要求とバッファーを取得するか、または別の適切な手段によって、後続の lineGetRequest を遅延させます。
後続のLINE_REQUESTは TAPI によって繰り返されないため、無視しないでください。
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineGetRequest を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
tapiRequestMakeCall を