lineGetMessage 函式 (tapi.h)

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

語法

LONG lineGetMessage(
  HLINEAPP      hLineApp,
  LPLINEMESSAGE lpMessage,
  DWORD         dwTimeout
);

hLineApp

lineInitializeEx 傳回的句柄。應用程式必須在LINEINITIALIZEEXPARAMS結構的 dwOptions 成員中設定LINEINITIALIZEEXOPTION_USEEVENT選項。

lpMessage

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

dwTimeout

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

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

LINEERR_INVALAPPHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER LINEERR_NOMEM。

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

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