tapiRequestMakeCall 函式 (tapi.h)
tapiRequestMakeCall 函式會要求建立語音通話。 呼叫管理員應用程式負責代表要求的應用程式建立呼叫,然後由使用者的呼叫管理員應用程式控制。
語法
LONG tapiRequestMakeCall(
LPCSTR lpszDestAddress,
LPCSTR lpszAppName,
LPCSTR lpszCalledParty,
LPCSTR lpszComment
);
參數
lpszDestAddress
呼叫要求 之 Null 終止目的地位址所在的記憶體位置指標。 位址可以使用 標準位址 格式。 這項作業不會檢查指定位址的有效性。 位址的最大長度是 TAPIMAXDEULTDRESSSIZE 字元,其中包含 NULL 終止符。
lpszAppName
呼叫要求之 Null 終止使用者易記應用程式名稱所在的記憶體位置指標。 如果應用程式未提供應用程式名稱,則此指標可以保留 NULL 。 位址的最大長度是 TAPIMAXAPPNAMESIZE 字元,其中包含 NULL 終止符。 較長字串會被截斷。
lpszCalledParty
記憶體位置的指標,該位置的呼叫方名稱為 Null 終止的呼叫方名稱所在的位置。 如果應用程式不想要提供這項資訊,這個指標可以保留 NULL 。 字串的最大長度是 TAPIMAXCALLEDPARTYSIZE 字元,其中包含 NULL 終止符。 較長字串會被截斷。
lpszComment
指向有關呼叫之 Null 終止批注所在記憶體位置的指標。 如果應用程式未提供批注,此指標可以保留 NULL 。 位址的最大長度是 TAPIMAXCOMMENTSIZE 字元,其中包含 NULL 終止符。 較長字串會被截斷。
傳回值
如果要求成功,則傳回零,如果發生錯誤,則傳回負錯誤號碼。 可能的錯誤傳回值為:
TAPIERR_NOREQUESTRECIPIENT、TAPIERR_INVALDESTADDRESS、TAPIERR_REQUESTQUEUEFULL TAPIERR_INVALPOINTER。
備註
啟用電話語音的應用程式可以藉由叫用 tapiRequestMakeCall 來要求代表呼叫,只提供通話的目的地位址。 此要求會轉送到使用者的呼叫控制應用程式,以代表原始應用程式來撥打呼叫。 默認通話控制應用程式會作為電話語音的一部分提供。 用戶可以將其取代為其選擇的呼叫控制應用程式。
當沒有呼叫控件應用程式執行時叫用 tapiRequestMakeCall 會傳回TAPIERR_NOREQUESTRECIPIENT錯誤指示。 如果呼叫控件應用程式未執行,TAPI 會嘗試啟動最高優先順序的呼叫控件應用程式, (登錄) 中針對 RequestMakeCall 列出。 當輔助 TAPI 要求佇列已滿時,叫用此函式會傳回TAPIERR_REQUESTQUEUEFULL錯誤。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |