2.2.4.1.3.37 GetNewCalls

The GetNewCalls packet is transmitted from a TAPI client to a TAPI server in a remote procedure call. Sending this packet returns call handles to calls on a specified line or address for which the application currently does not have handles. The client is granted owner privilege to these calls.

0	1	2	3	4	5	6	7	8	9	1 0	1	2	3	4	5	6	7	8	9	2 0	1	2	3	4	5	6	7	8	9	3 0	1
Req_Func
Reserved1
hLine
dwAddressID
dwSelect
pCallList
Reserved2
Reserved3
Reserved4
Reserved5
Reserved6
Reserved7
Reserved8
Reserved9
Reserved10
VarData (variable)
...

Req_Func (4 bytes): An unsigned 32-bit integer. The identifier of the function that will be invoked on the remote server. This value MUST be set to 39.

Return Values

On completion of ClientRequest, this field contains the result of the encapsulated telephony request. A value of 0 indicates success, and a LINEERR_Constants value indicates failure. The remote server MUST complete this call synchronously.

MUST return zero if the request succeeds or a negative error number if an error occurs. Common return values are:

Name	Value
LINEERR_INVALADDRESSID	0x80000011
LINEERR_OPERATIONFAILED	0x80000048
LINEERR_INVALCALLSELECT	0x8000001B
LINEERR_RESOURCEUNAVAIL	0x8000004B
LINEERR_INVALLINEHANDLE	0x8000002B
LINEERR_STRUCTURETOOSMALL	0x8000004D
LINEERR_INVALPOINTER	0x80000035
LINEERR_UNINITIALIZED	0x80000050
LINEERR_NOMEM	0x80000044

Reserved1 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.

hLine (4 bytes): An HLINE. The handle to an open line device. This field MUST have been obtained by sending the Openpacket.

dwAddressID (4 bytes): An unsigned 32-bit integer. The address on the specified open line device. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades. A valid value of dwAddressID is in the range 0 to dwNumAddresses –1. The client obtains dwNumAddresses from the LINEDEVCAPS obtained by sending a GetDevCaps packet to the remote server.

dwSelect (4 bytes): An unsigned 32-bit integer. The selection of calls that are requested. This parameter MUST be either LINECALLSELECT_ADDRESS or LINECALLSELECT_LINE.

pCallList (4 bytes): An unsigned 32-bit integer. The size, in bytes, of a LINECALLLIST packet that contains a list of handles to calls on the specified line or address for which the client currently does not have handles, upon successful completion of the request.

On successful completion, this field MUST contain the offset, in bytes, of the packet in the VarData field.

Reserved2 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.

Reserved3 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.

Reserved4 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.

Reserved5 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.

Reserved6 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.

Reserved7 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.

Reserved8 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.

Reserved9 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.

Reserved10 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.

VarData (variable): This field is present only on successful completion of the request and contains a LINECALLLIST packet.

The contents of this field MUST be DWORD-aligned, as specified in [MS-DTYP] section 2.2.9.