2.2.4.1.7.11 FreeDialogInstance
The FreeDialogInstance packet indicates the end of the TSP installation, configuration, or removal operation on the client side. The client MUST have started this operation by sending the GetUIDllName packet, and this operation might have had one or more TUISPIDLLCallback packets sent by the client during the operation. The server takes appropriate action corresponding to the end of this operation, for example, completing the configuration of the server and the TSP, or allocating or releasing resources.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Req_Func |
|||||||||||||||||||||||||||||||
|
Reserved1 |
|||||||||||||||||||||||||||||||
|
htDlgInst |
|||||||||||||||||||||||||||||||
|
lUIDllResult |
|||||||||||||||||||||||||||||||
|
Reserved2 |
|||||||||||||||||||||||||||||||
|
Reserved3 |
|||||||||||||||||||||||||||||||
|
Reserved4 |
|||||||||||||||||||||||||||||||
|
Reserved5 |
|||||||||||||||||||||||||||||||
|
Reserved6 |
|||||||||||||||||||||||||||||||
|
Reserved7 |
|||||||||||||||||||||||||||||||
|
Reserved8 |
|||||||||||||||||||||||||||||||
|
Reserved9 |
|||||||||||||||||||||||||||||||
|
Reserved10 |
|||||||||||||||||||||||||||||||
|
Reserved11 |
|||||||||||||||||||||||||||||||
|
Reserved12 |
|||||||||||||||||||||||||||||||
Req_Func (4 bytes): The identifier of the function that will be invoked on the remote server. This value MUST be set to 3.
-
On completion of the ClientRequest method, this field MUST contain 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.
Reserved1 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
htDlgInst (4 bytes): An opaque handle that was returned by the server in the corresponding htDlgInst field of the GetUIDllName packet. This opaque handle value cannot be used further after it is used in a FreeDialogInstance packet.
lUIDllResult (4 bytes): This field MUST be set to 0 if the current operation (as identified by htDlgInst, namely, installing, configuring, or removing a TSP) was successfully completed on the client side, and set to nonzero to indicate that the operation was unsuccessful or canceled on the client side. Correspondingly, the server either terminates and cleans up the setup involved for the current operation or completes the work remaining on the server side for the current operation.
Reserved2 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved3 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved4 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved5 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved6 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved7 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved8 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved9 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved10 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved11 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.
Reserved12 (4 bytes): An unsigned 32-bit integer. This MUST be 0x00000000 and ignored on receipt.