lineRegisterRequestRecipient 函式 (tapi.h)

發行項
03/02/2024

lineRegisterRequestRecipient 函式會將叫用應用程式註冊為指定要求模式的要求收件者。

語法

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

參數

hLineApp

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

dwRegistrationInstance

傳回做為LINE_REQUEST訊息參數的應用程式特定 DWORD。此訊息會通知應用程式要求擱置中。如果 bEnable 設定為零，則會忽略此參數。 TAPI 只會檢查此參數以進行註冊，而不是取消註冊。取消註冊時所使用的 dwRegistrationInstance 值不需要符合註冊要求模式時所使用的 dwRegistrationInstance 。

dwRequestMode

應用程式註冊的要求類型。此參數使用一或多個 LINEREQUESTMODE_常數。

bEnable

如果 為 TRUE，應用程式會註冊指定的要求模式;如果 為 FALSE，則為應用程式取消註冊指定的要求模式。

傳回值

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

LINEERR_INVALAPPHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALREQUESTMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM LINEERR_UNINITIALIZED。

備註

已啟用電話語音的應用程式可以藉由叫用 tapiRequestMakeCall 來要求代表呼叫。此外，其他應用程式可以要求以指定的呼叫記錄該資訊。 tapiRequestMakeCall 要求會由TAPI排入佇列，而已註冊處理要求的最高優先順序應用程式會傳送LINE_REQUEST訊息，並指出擱置的要求模式。此應用程式通常是使用者的呼叫控制應用程式。

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

當收件者應用程式執行 lineShutdown時，也會針對所有要求自動取消註冊。