lineRegisterRequestRecipient 関数 (tapi.h)

[アーティクル]
03/13/2024

lineRegisterRequestRecipient 関数は、呼び出し元のアプリケーションを、指定された要求モードの要求の受信者として登録します。

構文

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

パラメーター

hLineApp

TAPI の行部分に対するアプリケーションの使用ハンドル。

dwRegistrationInstance

LINE_REQUEST メッセージのパラメーターとして返されるアプリケーション固有の DWORD。このメッセージは、要求が保留中であることをアプリケーションに通知します。 bEnable が 0 に設定されている場合、このパラメーターは無視されます。このパラメーターは、登録解除ではなく、登録のためだけに TAPI によって検査されます。登録解除中に使用される dwRegistrationInstance 値は、要求モードの登録時に使用される dwRegistrationInstance と一致する必要はありません。

dwRequestMode

アプリケーションが登録する要求の種類。このパラメーターでは、1 つ以上の LINEREQUESTMODE_定数を使用します。

bEnable

TRUE の場合、アプリケーションは指定した要求モードを登録します。FALSE の場合、アプリケーションは指定された要求モードの登録を解除します。

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。可能な戻り値は次のとおりです。

LINEERR_INVALAPPHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALREQUESTMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

注釈

テレフォニー対応アプリケーションは、 tapiRequestMakeCall を呼び出すことによって、その代わりに呼び出しを行う必要があります。さらに、他のアプリケーションは、特定の呼び出しで情報をログに記録することを要求できます。 tapiRequestMakeCall 要求は TAPI によってキューに登録され、要求を処理するために登録されている最も優先度の高いアプリケーションには、保留中の要求のモードを示すLINE_REQUEST メッセージが送信されます。このアプリケーションは、通常、ユーザーの呼び出し制御アプリケーションです。

次に、このメッセージを受信する呼び出し制御アプリケーションは lineGetRequest を呼び出し、要求モードと、要求を保持するのに十分な大きさのバッファーを指定します。その後、呼び出し制御アプリケーションは要求を解釈して実行します。

受信者アプリケーションは、 lineShutdown を実行すると、すべての要求に対して自動的に登録解除されます。