lineSetAppPriority 関数 (tapi.h)

[アーティクル]
03/08/2023

lineSetAppPriority 関数を使用すると、アプリケーションは特定のメディアタイプまたは支援テレフォニー要求モードのハンドオフ優先度リストで優先度を設定したり、優先度リストからそれ自体を削除したりできます。

構文

LONG lineSetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPCSTR            lpszExtensionName,
  DWORD             dwPriority
);

パラメーター

lpszAppFilename

ディレクトリデータを含まない、アプリケーション実行可能モジュールのファイル名を含む文字列へのポインター。 TAPI バージョン 2.0 以降では、パラメーターでファイル名を long または 8.3 のファイル名形式で指定できます。

dwMediaMode

アプリケーションの優先順位を設定するメディアの種類。値には、1 つ以上の LINEMEDIAMODE 定数を指定できます。値 0 を使用して、支援テレフォニー要求のアプリケーション優先度を設定する必要があります。

lpExtensionID

LINEEXTENSIONID 型の構造体へのポインター。このパラメーターは無視されます。

dwRequestMode

このパラメーターの条件は、 dwMediaMode パラメーターが 0 の場合、優先順位を設定する Assisted テレフォニー要求モードを指定します。 LINEREQUESTMODE_MAKECALLする必要があります。 dwMediaMode が 0 以外の場合、このパラメーターは無視されます。

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_定数の 1 つではありません。

この関数は、格納されている優先度リストを更新します。テレフォニーシステムが初期化されている場合は、実行中のアプリケーションの現在のアクティブな優先順位も設定されます。新しい優先度は、メディアの種類に基づいて、次の着信呼び出しまたは lineHandoff で使用されます。

lineSetAppPriority で設定された優先度は、システムの再起動または tapisrv の再起動間で保持されます。 lineOpen 関数は、呼び出しの優先順位を指定しない行を開きます。既定では、最も優先度の高いアプリケーションは、最初に lineOpen と呼ばれるアプリケーションになります。