2.2.5.2 TAPI32_MSG

The TAPI32_MSG packet is used in the following situations:

  • Requests from the client to the server to specify a function type.

  • Acknowledgments from the server to the client to specify a return value.


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/Ack_ReturnValue

Reserved1

PARAMETERS FOR REQUEST (52 bytes)

...

...

VarData (variable)

...

Req_Func/Ack_ReturnValue (4 bytes): An unsigned 32-bit integer. The function type requested by the client from the server.

The return value from the server request. The following table lists the possible return values.

Value

Meaning

TAPI_SUCCESS

0x00000000

The requested function is valid.

TAPIERR_INVALRPCCONTEXT

0x0000F101

The RPC request is made with an invalid handle.

LINEERR_INVALPARAM

0x80000032

A parameter or packet that a parameter points to contains invalid information.

LINEERR_OPERATIONUNAVAIL

0x80000049

The operation is not available.

LINEERR_REINIT

0x80000052

The application attempted to initialize TAPI twice.

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

PARAMETERS FOR REQUEST (52 bytes): An unsigned 32-bit integer. The parameters for the request. The size of the Params array MUST be specified by MAX_TAPI_FUNC_ARGS, which has a value of 13.

VarData (variable): Any variable length data. This field is dependent on packet usage.

This packet serves as a template for the Request Packets.