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。