lineGetRequest 函式 (tapi.h)

發行項
03/05/2024

lineGetRequest 函式會擷取指定要求模式的下一個依 Proxy 要求。

語法

LONG lineGetRequest(
  HLINEAPP hLineApp,
  DWORD    dwRequestMode,
  LPVOID   lpRequestBuffer
);

參數

hLineApp

TAPI 行部分的應用程式使用句柄。

dwRequestMode

要取得的要求類型。請注意 ，dwRequestMode 只能設定一個位。此參數只會使用其中一個 LINEREQUESTMODE_常數。

lpRequestBuffer

要放置要求之參數的記憶體緩衝區指標。緩衝區的大小，以及放置於緩衝區的數據解譯取決於要求模式。應用程式配置的緩衝區假設為足夠的大小來保存要求。

如果 dwRequestMode 是LINEREQUESTMODE_MAKECALL，請使用 LINEREQMAKECALL 結構解譯要求緩衝區的內容。

LINEREQUESTMODE_MEDIACALL已過時。如需詳細資訊，請參閱 tapiRequestMediaCall。

傳回值

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

LINEERR_INVALAPPHANDLE、LINEERR_NOTREGISTERED、LINEERR_INVALPOINTER、LINEERR_OPERATIONFAILED、LINEERR_INVALREQUESTMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZEDLINEERR_NOREQUEST。

備註

已啟用電話語音的應用程式可以藉由叫用 tapiRequestMakeCall 來要求代表呼叫。這些要求會由 TAPI 排入佇列，而且已註冊來處理要求的最高優先順序應用程式會傳送 LINE_REQUEST 訊息，並指出擱置的要求模式。一般而言，此應用程式是使用者的呼叫控制應用程式。 LINE_REQUEST訊息表示註冊的應用程式可能擱置零或多個要求要處理;收到LINE_REQUEST之後，收件者應用程式必須負責呼叫 lineGetRequest ，直到傳回LINEERR_NOREQUEST為止，表示沒有任何要求擱置中。

接下來，接收此訊息的呼叫控制應用程式會叫用 lineGetRequest，並指定要求模式和足以保存要求的緩衝區。接著，呼叫控件應用程式會解譯並執行要求。

執行 lineGetRequest 之後，TAPI 會從其內部佇列中清除要求，讓會議室可供後續要求使用。因此，新的 LINE_REQUEST 訊息在執行 lineGetRequest時立即收到，應該相同或另一個應用程式發出另一個要求。要求收件者應用程式必須負責由某些機制處理此案例;例如，藉由記下其他LINE_REQUEST，並延遲後續 的lineGetRequest ，直到處理上述要求完成為止、視需要取得後續要求和緩衝區，或依其他適當方式進行。

不應忽略後續的LINE_REQUEST，因為 TAPI 不會重複。