4.1.0.6 LINE_CLOSE

This message is sent when the specified line device has been forcibly closed. The line device handle or any call handles for calls on the line are no longer valid once this message has been sent. The Service Provider guarantees that all asynchronous requests on the line and all calls on the line have been reported complete by calling ASYNC_LINE_COMPLETION for each outstanding request before this message is sent. The TAPI DLL must not request any future operations using this line handle or its associated call handles.

Sent to

LINEEVENT


Parameters

HTAPILINE htLine
Specifies the TAPI DLL's opaque object handle to the line device.

HTAPICALL htCall
Unused

DWORD dwMsg
The value LINE_CLOSE

DWORD dwParam1
Unused.

DWORD dwParam2
Unused.

DWORD dwParam3
Unused.

Comments

This message is only sent to the TAPI DLL after an open line has been forcibly closed. This may be done, for example, when taking the line out of service or reconfiguring the Service Provider. Whether or not the line can be reopened immediately after a forced close is up to the Service Provider.

See Also

None.