2.2.4.1.3.5 BlindTransfer
The BlindTransfer packet is transmitted from a TAPI client to a TAPI server in a remote procedure call. Sending this packet performs a blind or single-step transfer of the specified call to the specified destination address.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Req_Func |
|||||||||||||||||||||||||||||||
Reserved1 |
|||||||||||||||||||||||||||||||
dwRequestID |
|||||||||||||||||||||||||||||||
hCall |
|||||||||||||||||||||||||||||||
lpszDestAddress |
|||||||||||||||||||||||||||||||
dwCountryCode |
|||||||||||||||||||||||||||||||
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 8.
-
Return Values
-
On completion of ClientRequest, this field contains the result of the encapsulated telephony request. A nonzero request ID value indicates that the request is in progress and will complete asynchronously. A LINEERR_Constants value indicates synchronous failure.
-
Returns a positive request identifier if the function will be completed asynchronously or a negative error number if an error occurs. The dwParam2 parameter of the corresponding LINE_REPLY packet is zero if the function succeeds, or it is a negative error number if an error occurs. If the client specified a nonzero value in the dwRequestID field of the packet, the same value MUST be used for the returned positive request identifier.
-
The following table shows the return values for this function.
-
Value
Meaning
LINEERR_INVALCALLHANDLE
0x80000018
The handle to the call is invalid.
LINEERR_NOMEM
0x80000044
Not enough memory is available.
LINEERR_INVALCALLSTATE
0x8000001C
The call state is invalid.
LINEERR_OPERATIONFAILED
0x80000048
The operation failed.
LINEERR_ADDRESSBLOCKED
0x80000053
The address is blocked.
LINEERR_RESOURCEUNAVAIL
0x8000004B
The resource is unavailable.
LINEERR_INVALCOUNTRYCODE
0x80000022
The country/region code is invalid.
Reserved1 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.
dwRequestID (4 bytes): An unsigned 32-bit integer. The identifier of the asynchronous request.
hCall (4 bytes): An HCALL. The handle to the call to be transferred. One way in which the client can obtain a valid hCall is from the LINE_CALLSTATE packet sent by the remote server. The application MUST be an owner of this call. The call state of hCall must be connected. For hCall to be in connected state, the client needs to send an Answer packet to the remote server.
lpszDestAddress (4 bytes): An unsigned 32-bit integer. The offset, in bytes, in the VarData field of a null-terminated Unicode string that identifies where to transfer the call.
dwCountryCode (4 bytes): An unsigned 32-bit integer. The country code of the destination. The implementation SHOULD use this field to select the call progress protocols for the destination address. If a value of 0 is specified, the service provider SHOULD use a default. TAPI does not validate dwCountryCode when this function is called.
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): Contains a null-terminated Unicode string that is indicated in the lpszDestAddress field.