lineGetAddressStatus
A version of this page is also available for
4/8/2010
This function allows an application to query the specified address for its current status.
Note
This function is for TAPI version 2.0 and later.
Syntax
LONG WINAPI lineGetAddressStatus(
HLINE hLine,
DWORD dwAddressID,
LPLINEADDRESSSTATUS lpAddressStatus
);
Parameters
- hLine
Handle to the open line device.
- dwAddressID
Address on the given open line device. This is the address to be queried. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.
- lpAddressStatus
Pointer to a variably sized data structure of type LINEADDRESSSTATUS. Prior to calling lineGetAddressStatus, the application should set the dwTotalSize member of this structure to indicate the amount of memory available to TAPI for returning information.
Return Value
Returns zero if the request succeeds or a negative error number if an error occurs. The following table shows the return values for this function.
| Value | Description |
|---|---|
LINEERR_INVALADDRESSID |
The address identifier is invalid. |
LINEERR_RESOURCEUNAVAIL |
The resources are unavailable. |
LINEERR_INVALLINEHANDLE |
The handle to the open line device is invalid. |
LINEERR_STRUCTURETOOSMALL |
The structure is too small. |
LINEERR_INVALPOINTER |
The pointer is invalid. |
LINEERR_UNINITIALIZED |
A parameter is uninitialized. |
LINEERR_NOMEM |
Not enough memory is available. |
LINEERR_OPERATIONUNAVAIL |
The operation is unavailable. |
LINEERR_OPERATIONFAILED |
The operation failed. |
Requirements
| Header | tapi.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |