lineAgentSpecific 函式 (tapi.h)

發行項
03/02/2024

lineAgentSpecific 函式可讓應用程式存取與地址相關聯之代理程式處理程式的專屬處理程式特定函式。擴充功能的意義是代理程序處理程式特有的。每組代理程式相關延伸模組都是由一個通用唯一的128位擴充功能標識碼來識別，該標識碼必須連同擴充功能的規格一起從該擴充功能 (通常是電話語音伺服器上代理程式處理程式軟體的作者) 。代理程式處理程式所支援的延伸模組清單是從lineGetAgentCaps所傳回的LINEAGENTCAPS結構取得。

語法

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

參數

hLine

開啟行裝置的句柄。

dwAddressID

開啟行裝置上的位址。位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。

dwAgentExtensionIDIndex

在所叫用代理程式處理程式延伸模組的LINEAGENTCAPS中ExtensionIDList結構中的位置。

lpParams

用來保存參數區塊的記憶體區域指標。此參數區塊的格式是裝置特定，而且其內容會由TAPI在電話語音伺服器上的代理程式處理程式應用程式來回傳遞。此參數區塊必須指定要叫用的函式，並包含足夠的空間，以便傳回任何數據。

dwSize

參數區塊區域的大小，以位元組為單位。

注意如果 lpParams 是字串的指標，則大小必須包含 NULL 終止符。

傳回值

如果異步操作啟動，則傳回正要求標識符;否則，此函式會傳回下列其中一個負誤差值：

LINEERR_INVALADDRESSID、LINEERR_INVALAGENTID、LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL LINEERR_STRUCTURETOOSMALL LINEERR_UNINITIALIZED。

其他傳回值是代理程序處理程式特有的。