共用方式為


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

另請參閱

輔助電話語音服務參考

TAPI 2.2 參考概觀