phoneGetMessage 函式 (tapi.h)

phoneGetMessage 函式會傳回下一個已排入佇列以傳遞至使用事件句柄通知機制的應用程式的 TAPI 訊息， (請參閱 phoneInitializeEx 以取得進一步的詳細數據) 。

語法

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

hPhoneApp

phoneInitializeEx 所傳回的句柄。應用程式必須在 PHONEINITIALIZEEXPARAMS 結構的 dwOptions 成員中設定PHONEINITIALIZEEXOPTION_USEEVENT選項。

lpMessage

PHONEMESSAGE 結構的指標。從此函式成功傳回時，結構會包含下一個已排入佇列以傳遞至應用程式的訊息。

dwTimeout

超時時間間隔，以毫秒為單位。如果間隔經過，則函式會傳回，即使無法傳回任何訊息也一樣。如果 dwTimeout 為零，函式會檢查佇列訊息，並立即傳回。如果 dwTimeout 是 INFINITE，函式的逾時間隔永遠不會經過。

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

PHONEERR_INVALAPPHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPOINTER、PHONEERR_NOMEM。

如果已使用非零逾時呼叫此函式，且應用程式在另一個線程上呼叫 phoneShutdown ，則此函式會立即傳回 PHONEERR_INVALAPPHANDLE。

如果逾時過期 (或為零) ，而且無法從佇列擷取任何訊息，則函式會傳回錯誤PHONEERR_OPERATIONFAILED。