lineGetAddressID 函式 (tapi.h)

發行項
03/02/2024

lineGetAddressID 函式會以不同格式傳回指定行上與地址相關聯的位址標識碼。

語法

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

參數

hLine

開啟行裝置的句柄。

lpdwAddressID

傳回位址識別碼的 DWORD 大小記憶體位置指標。位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。

dwAddressMode

lpsAddress 中包含的地址位址模式。此參數只會使用其中一個 LINEADDRESSMODE_常數。您必須指定LINEADDRESSMODE_DIALABLEADDR。

lpsAddress

保存指派給指定行裝置之地址的數據結構指標。位址的格式取決於 dwAddressMode。因為唯一的有效值是LINEADDRESSMODE_DIALABLEADDR， 所以 lpsAddress 會使用通用可撥號號碼格式，並且以 Null 終止。

dwSize

lpsAddress 中包含的位址大小，以位元組為單位。字串的大小必須包含 Null 終止符。

傳回值

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSMODE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALADDRESS、LINEERR_UNINITIALIZED、LINEERR_NOMEM。

備註

lineGetAddressID 函式可用來將電話號碼對應 (位址，) 指派給線路裝置的 dwAddressID，範圍中的 dwAddressID 到該行裝置功能中傳回的位址數目減一。 lineMakeCall 函式可讓應用程式藉由在行上指定行句柄和地址來進行呼叫。位址可以指定為 dwAddressID、電話號碼或裝置特定名稱或標識碼。在單一行指派多個位址的環境中，使用電話號碼可能很實用。

注意 LINEADDRESSMODE_ADDRESSID不能與 lineGetAddressID搭配使用。