4.1.1.18 PHONE_CLOSE

This message is sent when an open phone device has been forcibly closed. The phone device handle is longer valid once this message has been sent. The Service Provider guarantees that all asynchronous requests on the phone have been reported complete by calling ASYNC_PHONE_COMPLETION for each outstanding request before this message is sent. The TAPI DLL must not request any future operations using this phone handle.

Sent to

PHONEEVENT

Parameters

HTAPIPHONE htPhone
Specifies the TAPI DLL's opaque object handle to the phone device.

DWORD dwMsg
The value PHONE_CLOSE

DWORD dwParam1
Unused.

DWORD dwParam2
Unused.

DWORD dwParam3
Unused.

Comments

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

See Also

Functions: TSPI_phoneClose