TSPI_linePark関数 (tspi.h)

[アーティクル]
09/27/2022

TSPI_linePark関数は、指定したパークモードに従って、指定された呼び出しをパークします。

構文

LONG TSPIAPI TSPI_linePark(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  DWORD         dwParkMode,
  LPCWSTR       lpszDirAddress,
  LPVARSTRING   lpNonDirAddress
);

パラメーター

dwRequestID

非同期要求の識別子。

hdCall

パークする呼び出しのハンドル。 hdCall の呼び出し状態は接続できます。

dwParkMode

コールがパークされるパークモード。 LINEPARKMODE_定数の 1 つだけ。

lpszDirAddress

ダイレクトパークを使用するときに呼び出しをパークするアドレスを示す null で終わる Unicode 文字列へのポインター。アドレスはダイヤル可能なアドレス形式です。このパラメーターは、無向公園では無視されます。

lpNonDirAddress

VARSTRING 型の構造体へのポインター。無向公園の場合、コールがパークされるアドレスがこの構造体で返されます。このパラメーターは、有向公園では無視されます。 VARSTRING 構造体内では、dwStringFormat を STRINGFORMAT_ASCII (null で終わる文字列を含む ASCII 文字列バッファー) に設定する必要があり、終了する NULL は dwStringSize で考慮されます。 lpNonDirAddress パラメーターが指すメモリが要求されたアドレスに対して十分な大きさでない場合、TSPI_linePark関数はLINEERR_STRUCTURETOOSMALLを返します。

戻り値

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

LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALPARKMODE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESS、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL。

注釈

varSTRING 構造体のすべてのメンバー (dwTotalSize を除く) は、サービスプロバイダーによって入力されます。 dwTotalSize メンバーは TAPI によって入力され、サービスプロバイダーはこの値を上書きしないでください。

ダイレクトパークでは、クライアントアプリケーション (TAPI を使用) は、通話を保留にするアドレスを指定します。無向公園の下で、スイッチはアドレスを判別し、TAPI にこれを提供します。どちらの場合も、このアドレスを指定することで、パークされた呼び出しを解除できます。

通常、パークされた呼び出しは、正常にパークされた後に アイドル状態 になります。サービスプロバイダーは、 LINE_CALLSTATE メッセージを使用して新しい状態を報告します。後続のTSPI_lineUnpark では、TSPI_lineCloseCallが古いハンドルを破棄したかどうかに関係なく、新しい個別の呼び出しハンドルが作成されます。

一部のスイッチは、通話が長時間保留された後にユーザーに通知できます。サービスプロバイダーは、呼び出し理由がアラームに設定されたオファリング通話として TAPI にこれを報告します (これがわかっていれば)。