phoneGetMessage 関数 (tapi.h)

  • [アーティクル]

phoneGetMessage 関数は、イベント ハンドル通知メカニズムを使用しているアプリケーションに配信するためにキューに入っている次の TAPI メッセージを返します (詳細については、「phoneInitializeEx」を参照してください)。

構文

LONG phoneGetMessage(
  HPHONEAPP      hPhoneApp,
  LPPHONEMESSAGE lpMessage,
  DWORD          dwTimeout
);

パラメーター

hPhoneApp

phoneInitializeEx によって返されるハンドル。 アプリケーションは、PHONEINITIALIZEEXPARAMS 構造体の dwOptions メンバーに PHONEINITIALIZEEXOPTION_USEEVENT オプションを設定している必要があります。

lpMessage

PHONEMESSAGE 構造体へのポインター。 この関数から正常に戻ると、構造体には、アプリケーションへの配信のためにキューに入れていた次のメッセージが含まれます。

dwTimeout

タイムアウト間隔 (ミリ秒単位)。 この関数は、メッセージが返されない場合でも、間隔が経過すると を返します。 dwTimeout が 0 の場合、関数はキューに登録されたメッセージを確認し、すぐにを返します。 dwTimeout が INFINITE の場合、関数のタイムアウト間隔は経過しません。

戻り値

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

PHONEERR_INVALAPPHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPOINTER、PHONEERR_NOMEM。

注釈

この関数が 0 以外のタイムアウトで呼び出され、アプリケーションが別のスレッドで phoneShutdown を 呼び出す場合、この関数は PHONEERR_INVALAPPHANDLE を使用して直ちにを返します。

タイムアウトが期限切れ (またはゼロ) で、キューからメッセージをフェッチできなかった場合、関数はエラー PHONEERR_OPERATIONFAILEDと共に を返します。

要件

要件 値
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

PHONEINITIALIZEEXPARAMS

PHONEMESSAGE

phoneInitializeEx

phoneShutdown