lineReleaseUserUserInfo 函式 (tapi.h)

發行項
08/26/2023

lineReleaseUserUserInfo函式會通知服務提供者應用程式已處理LINECALLINFO結構中包含的使用者使用者資訊，而且後續收到的使用者資訊現在可以寫入該結構。服務提供者會傳送 LINE_CALLINFO 訊息，指出有新的資訊可用時LINECALLINFOSTATE_USERUSERINFO。

語法

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

參數

hCall

呼叫的控制碼。應用程式必須是呼叫的擁有者。 hCall的撥號狀態可以是任何狀態。

傳回值

如果函式是以非同步方式完成，則傳回正向要求識別碼，如果發生錯誤，則傳回負錯誤號碼。如果函式成功或發生錯誤，則對應LINE_REPLY訊息的dwParam2參數為零。可能的傳回值為：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_NOTOWNER、LINEERR_UNINITIALIZED LINEERR_OPERATIONUNAVAIL。

備註

lineReleaseUserUserInfo函式可讓應用程式控制 ISDN 連線上傳入使用者使用者資訊的流程。收到新的使用者使用者資訊訊息時，服務提供者會使用指定 LINECALLINFOSTATE_USERUSERINFO) (LINE_CALLINFO 訊息通知應用程式。任何數目的應用程式都可以使用 lineGetCallInfo) 來檢查資訊 (，但應用程式在釋放資訊時擁有呼叫控制項，以便報告後續的資訊。在呼叫 lineReleaseUserUserInfo之後，服務提供者不會以較新的資訊覆寫LINECALLINFO中的先前使用者資訊。服務提供者負責緩衝後續接收的使用者使用者資訊，直到擁有呼叫的應用程式釋放先前的資訊為止。