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,范围为 0 到地址数减去线路设备功能中返回的地址数。 lineMakeCall 函数允许应用程序通过在行上指定行句柄和地址进行调用。 地址可以指定为 dwAddressID、电话号码或设备特定的名称或标识符。 在为单行分配多个地址的环境中,使用电话号码可能很实用。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tapi.h |
Library | Tapi32.lib |
DLL | Tapi32.dll |