linePark 関数は、指定されたパーク モードに従って指定された呼び出しをパークします。
構文
LONG lineParkA(
HCALL hCall,
DWORD dwParkMode,
LPCSTR lpszDirAddress,
LPVARSTRING lpNonDirAddress
);
パラメーター
hCall
パークする呼び出しへのハンドル。 アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態
dwParkMode
コールがパークされるパーク モード。 このパラメーターにはフラグを 1 つだけ設定でき、LINEPARKMODE_ 定数のいずれかを使用します。
lpszDirAddress
ダイレクト パークを使用するときに呼び出しが保留されるアドレスを示す、null終了文字列へのポインター。 アドレスはダイヤル可能な番号形式です。 このパラメーターは、非方向公園では無視されます。
lpNonDirAddress
VARSTRING
戻り値
関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。 対応する LINE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。 可能な戻り値は次のとおりです。
LINEERR_INVALADDRESS、LINEERR_NOTOWNER、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALPARKMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。
備考
ダイレクト パークを使用すると、アプリケーションは通話を保留するアドレスを決定します。 無向公園では、スイッチはアドレスを決定し、これをアプリケーションに提供します。 どちらの場合も、このアドレスを指定することで、パークされた通話を解除できます。
通常、パークされた呼び出しは、正常にパークされた後に アイドル状態 状態になり、アプリケーションはそのハンドルを呼び出しに割り当て解除する必要があります。 アプリケーションがパークされた呼び出しに対して lineUnpark を実行する場合、アプリケーションが古い呼び出しハンドルの割り当てを解除していない場合でも、未割り当て呼び出し用に新しい呼び出しハンドルが作成されます。
一部のスイッチでは、通話が長時間保留された後にユーザーに通知できます。 アプリケーションは、アラームに設定された通話理由 呼び出し
非方向パークでは、VARSTRING 構造体の dwTotalSize メンバーがパーク アドレスを受信するのに十分な量のメモリを指定していない場合、対応する応答メッセージはLINEERR_STRUCTURETOOSMALLエラー値を返します。 このような場合は、完全なパーク アドレスを取得する方法はありません。 LINEERR_STRUCTURETOOSMALLエラー値が返されると、nonDirAddress 構造体の dwNeededSize メンバーに有効な値が含まれていません。 非方向
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして linePark を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
VARSTRING を