lineGetAddressCaps
The lineGetAddressCaps
function queries the specified address on the specified line device to
determine its telephony capabilities.
LONG lineGetAddressCaps(
|
HLINEAPP hLineApp, |
|
|
DWORD dwDeviceID, |
|
|
DWORD dwAddressID, |
|
|
DWORD dwAPIVersion, |
|
|
DWORD dwExtVersion, |
|
|
LPLINEADDRESSCAPS lpAddressCaps |
|
|
); |
|
Parameters
hLineApp
The handle to
the application's registration with TAPI.
dwDeviceID
The line
device containing the address to be queried.
dwAddressID
The address
on the given line device whose capabilities are to be queried.
dwAPIVersion
The version
number of the Telephony API to be used. The high-order word contains the major
version number; the low-order word contains the minor version number. This
number is obtained by lineNegotiateAPIVersionUW_DUA.
dwExtVersion
The version
number of the service provider-specific extensions to be used. This number can
be left zero if no device-specific extensions are to be used. Otherwise, the
high-order word contains the major version number; and the low-order word contains
the minor version number.
lpAddressCaps
A pointer to
a variably sized structure of type LINEADDRESSCAPS. Upon successful completion
of the request, this structure is filled with address capabilities information.
Prior to calling lineGetAddressCaps, the application should set the dwTotalSize
field of this structure to indicate the amount of memory available to TAPI for
returning information.
Return Values
Returns zero
if the request is successful or a negative error number if an error has occurred.
Possible return values are:
LINEERR_BADDEVICEID,
LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION,
LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_STRUCTURETOOSMALL,
LINEERR_INVALAPPHANDLE, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER,
LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_NODEVICE.
Remarks
Valid address
IDs range from zero to one less than the number of addresses returned by lineGetDevCaps.
The version number to be supplied is the version number that was returned as
part of the line's device capabilities by lineGetDevCaps.
See Also