TSPI_lineDial関数 (tspi.h)

  • [アーティクル]

TSPI_lineDial関数は、指定した呼び出しで指定したダイヤル可能な番号をダイヤルします。

構文

LONG TSPIAPI TSPI_lineDial(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

パラメーター

dwRequestID

非同期要求の識別子。

hdCall

ダイヤルする呼び出しに対するサービス プロバイダーのハンドル。 hdCall の呼び出し状態は、アイドル状態と切断状態を除く任意の状態にすることができます。

lpszDestAddress

標準のダイヤル可能な番号形式を使用してダイヤルする宛先を指定する 、null で終わる Unicode 文字列へのポインター。

dwCountryCode

宛先の国または地域コード。 実装では、これを使用して宛先アドレスの呼び出し進行状況プロトコルを選択します。 値 0 を指定すると、サービス プロバイダーによって定義された既定の呼び出し進行状況プロトコルが使用されます。 TAPI は、この関数が呼び出されたときにこのパラメーターを検証しません。

戻り値

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESS、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALCOUNTRYCODE、LINEERR_DIALBILLING、LINEERR_INVALCALLSTATE、LINEERR_DIALQUIET、LINEERR_ADDRESSBLOCKED、LINEERR_DIALDIALTONE、LINEERR_NOMEM、LINEERR_DIALPROMPT、LINEERR_OPERATIONUNAVAIL。

注釈

呼び出しの現在の状態でダイヤルが許可されていない場合、サービス プロバイダーはLINEERR_INVALCALLSTATEを返します。

サービス プロバイダーは、LINEERR_INVALADDRESSを返す場合、ダイヤルを実行しません。

サービス プロバイダーがLINEERR_DIALBILLING、LINEERR_DIALQUIET、LINEERR_DIALDIALTONE、またはLINEERR_DIALPROMPTを返す場合、 TSPI_lineDial によって実行されるアクションは実行されません (たとえば、部分ダイヤルなし、offhook は実行されません)。 これは、サービス プロバイダーがサポートされていない文字の数を先に事前にスキャンする必要があるためです。

TSPI_lineDialは、既存のコールアピアランスでダイヤルするために使用されます。たとえば、lpszDestAddress として NULL を指定したTSPI_lineMakeCallから返される呼び出しハンドル、または ';' で終わる呼び出しハンドルは、TSPI_lineSetupTransferまたはTSPI_lineSetupConferenceから返される呼び出しハンドルです。 回線の デバイス機能で許可されている場合、マルチステージ ダイヤルの場合は、ダイヤル中にTSPI_lineDialを複数回呼び出すことができます。

TSPI_lineMakeCall関数または TSPI_lineDial 関数の前の呼び出しで lpszDestAddress パラメーターが指す文字列がセミコロンで終わる場合、TSPI_lineDialの現在の呼び出しの空の文字列は、ダイヤルが完了したことを示します。

CRLF で区切られた 1 つのダイヤル文字列に複数のアドレスを指定できます。 逆多重化を提供するサービス プロバイダーは、各アドレスで個々の物理呼び出しを確立し、アプリケーションへのすべての呼び出しの集計に 1 つの呼び出しハンドルを返すことができます。 すべての住所で同じ国または地域コードが使用されます。

ダイヤルは、呼び出しが最終的に接続された後ではなく、サービス プロバイダーによってアドレスが受け入れられた後に完了したと見なされます。 逆多重化を提供するサービス プロバイダーでは、一度に複数のアドレスを提供できます。 サービス プロバイダーは、呼び出しの進行状況を通知するために 、LINE_CALLSTATE メッセージを TAPI に送信する必要があります。

要件

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

こちらもご覧ください

ASYNC_COMPLETION

LINE_CALLSTATE

TSPI_lineMakeCall