Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This 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.

Syntax 

LONG WINAPI lineGetNewCalls(
  HLINE 
hLine,
  DWORD 
dwAddressID,
  DWORD 
dwSelect,
  LPLINECALLLIST 
lpCallList 
);

Parameters

hLine

Handle to an open line device.

dwAddressID

Address on the given open line device. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.

dwSelect

Selection of calls that are requested. This parameter uses one and only one of the LINECALLSELECTconstants.

lpCallList

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 dwTotalSizemember 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_OPERATIONFAILED

The operation failed.

LINEERR_INVALCALLSELECT

The selection of calls are invalid.

LINEERR_RESOURCEUNAVAIL

The resources are invalid.

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.

Remarks

An application can use lineGetNewCallsto 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 the lineGetCallInfoand lineGetCallStatusfunctions for each call in the list to determine the call's information and status, respectively. It can use the lineSetCallPrivilegefunction to change its privilege to owner.

Note:
This function is for TAPI version 2.0 and later.

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

See Also