lineGetAddressID 函式會傳回與指定行上不同格式地址相關聯的地址識別符。
語法
LONG lineGetAddressIDA(
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 範圍中的零到行裝置功能中傳回的位址數目減去一個。 lineMakeCall 函式可讓應用程式藉由指定行句柄和該行上的位址來進行呼叫。 位址可以指定為 dwAddressID、電話號碼或裝置特定名稱或標識符。 在單行指派多個位址的環境中，使用電話號碼可能很實用。
附注 LINEADDRESSMODE_ADDRESSID 不能與 lineGetAddressID搭配使用。
注意
tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineGetAddressID 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 窗戶 |
| 標頭 | tapi.h |
| 連結庫 | Tapi32.lib |
| DLL | Tapi32.dll |