lineGetNewCalls
The lineGetNewCalls
function returns call handles to calls on a specified line or address for
which the application currently does not have handles. The application is
granted monitor privilege to these calls.
LONG lineGetNewCalls(
|
HLINE hLine, |
|
|
DWORD dwAddressID, |
|
|
DWORD dwSelect, |
|
|
LPLINECALLLIST lpCallList |
|
|
); |
|
Parameters
hLine
A handle to
an open line device.
dwAddressID
An address on
the given open line device.
dwSelect
The selection
of calls that are requested. Note that dwSelect can only have one bit
set. This parameter uses the following LINECALLSELECT_ constants:
LINECALLSELECT_LINE
Selects calls
on the specified line device. The hLine parameter must be a valid line
handle; dwAddressID is ignored.
LINECALLSELECT_ADDRESS
Selects calls
on the specified address on the specified line device. Both hLine and dwAddressID
must be valid.
lpCallList
A pointer to
a variably sized data structure of type LINECALLLIST. Upon successful completion
of the request, call handles to all selected calls are returned in this
structure. Prior to calling lineGetNewCalls, 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_INVALADDRESSID,
LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_RESOURCEUNAVAIL,
LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER,
LINEERR_UNINITIALIZED, LINEERR_NOMEM.
Remarks
An
application can use lineGetNewCalls to obtain handles to calls for which
it currently has no handles. The application can select the calls for which
handles are to be returned by basing this selection on scope (calls on a
specified line, or calls on a specified address). For example, an application
can request call handles to all calls on a given address for which it currently
has no handle. The application is always given monitor privilege to the new
call handles. Also, when opening a line, an application uses this function to
become aware of existing calls.
The
application can invoke lineGetCallInfo and lineGetCallStatus for
each call in the list to determine the call's information and status,
respectively. It can use lineSetCallPrivilege to change its privilege to
owner.
See Also