TSPI_lineUnpark関数 (tspi.h)

  • [アーティクル]

TSPI_lineUnpark関数は、指定したアドレスにパークされた呼び出しを取得し、その呼び出しハンドルを返します。

構文

LONG TSPIAPI TSPI_lineUnpark(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HTAPICALL     htCall,
  LPHDRVCALL    lphdCall,
  LPCWSTR       lpszDestAddress
);

パラメーター

dwRequestID

非同期要求の識別子。

hdLine

呼び出しがパーク解除される行へのハンドル。

dwAddressID

unpark の発信元の hdLine のアドレス。 アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティング システムのアップグレード間で一定のままです。 TAPI は、この関数が呼び出されたときにこのパラメーターを検証しません。

htCall

新しい未パーク呼び出しへの TAPI ハンドル。 サービス プロバイダーはこれを保存し、呼び出しのイベントを報告する LINEEVENT プロシージャへの後続のすべての呼び出しで使用する必要があります。

lphdCall

新しい未パーク呼び出しのサービス プロバイダーの識別子を表す HDRVCALL へのポインター。 サービス プロバイダーは、このプロシージャが戻る前に、呼び出しのハンドルをこの場所に入力する必要があります。 関数でエラーが発生した場合、このハンドルは無効です。

lpszDestAddress

呼び出しがパークされるアドレスを含む null で終わる Unicode 文字列へのポインター。 アドレスはダイヤル可能なアドレス形式です。

戻り値

dwRequestID を返します。エラーが発生した場合はエラー番号を返します。 関数が成功した場合は対応するASYNC_COMPLETIONの実際のパラメーター lResult は 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。

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

解説

この関数は、呼び出しの有効期間を開始するために TSPI モデルに従うという点で、対応する TAPI 関数とは異なります。 TAPI とサービス プロバイダーは、呼び出しを表す不透明なハンドルを相互に交換します。 さらに、サービス プロバイダーは、このプロシージャから戻る前に、新しい呼び出しのコールバックを実行できます。 いずれの場合も、サービス プロバイダーは、一致する ASYNC_COMPLETION メッセージが成功を報告するまで、返されたハンドルを "まだ有効ではありません" として扱う必要があります。 つまり、新しい呼び出しに 対して LINEEVENT メッセージを発行したり、その行のメッセージまたは状態データ構造の呼び出し数に含めたりすることはできません。

この関数によって作成される呼び出しハンドルは、呼び出しの元の呼び出しハンドルがまだ存在する場合でも、新しい個別の呼び出しハンドルです ( TSPI_lineCloseCallによって破棄されていません)。

必要条件

   
対象プラットフォーム Windows
ヘッダー tspi.h

関連項目

ASYNC_COMPLETION

TSPI_lineCloseCall

TSPI_linePark