lineSetAppPriority 関数を使用すると、アプリケーションは特定のメディアタイプまたは支援テレフォニー要求モードのハンドオフ優先度リストで優先度を設定したり、優先度リストから自分自身を削除したりできます。
構文
LONG lineSetAppPriorityA(
LPCSTR lpszAppFilename,
DWORD dwMediaMode,
LPLINEEXTENSIONID lpExtensionID,
DWORD dwRequestMode,
LPCSTR lpszExtensionName,
DWORD dwPriority
);
パラメーター
lpszAppFilename
ディレクトリ データを含まない、アプリケーション実行可能モジュールのファイル名を含む文字列へのポインター。 TAPI バージョン 2.0 以降では、パラメーターは長いファイル名または 8.3 ファイル名の形式でファイル名を指定できます。
dwMediaMode
アプリケーションの優先度を設定するメディアの種類。 値には、LINEMEDIAMODE 定数を 1 つ以上指定できます。 値 0 を使用して、支援テレフォニー要求のアプリケーション優先度を設定する必要があります。
lpExtensionID
LINEEXTENSIONID
dwRequestMode
このパラメーターの条件は、dwMediaMode パラメーターが 0 の場合、このパラメーターは優先順位を設定する支援テレフォニー要求モードを指定します。 LINEREQUESTMODE_MAKECALLする必要があります。 dwMediaMode
lpszExtensionName
このパラメーターは無視されます。
dwPriority
アプリケーションの新しい優先度を示すパラメーター。 値 0 が渡されると、指定されたメディアまたは要求モードの優先順位リストからアプリケーションが削除されます。まだ存在しない場合は、エラーは生成されません。 値 1 が渡された場合、アプリケーションはメディアまたは要求モードの最も優先順位の高いアプリケーションとして挿入されます。リストに既に存在する場合は、優先度の低い位置から削除されます。 それ以外の値を指定すると、エラーが発生します。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
LINEERR_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER.
備考
LINEERR_INVALMEDIAMODE が返された場合、dwMediaMode で指定された値は 0 ではなく、LINEMEDIAMODE_ 定数。
この関数は、格納されている優先度リストを更新します。 テレフォニー システムが初期化されている場合は、実行中のアプリケーションの現在のアクティブな優先順位も設定されます。新しい優先度は、次の着信呼び出しで使用されるか、メディアの種類に基づいて lineHandoff
lineSetAppPriority で設定された優先順位は、システムの再起動または tapisrv の再起動の間に保持されます。
lineOpen 関数は、指定された呼び出し優先度なしで行を開きます。 既定では、最も優先度の高いアプリケーションは、最初に lineOpen
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineSetAppPriority を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
lineHandoff を