lineGetAddressID 函式 (tapi.h)

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搭配使用。

 

規格需求

需求	值
目標平台	Windows
標頭	tapi.h
程式庫	Tapi32.lib
Dll	Tapi32.dll

另請參閱

基本電話語音服務參考

TAPI 2.2 參考概觀

lineMakeCall