phoneClose
The phoneClose
function closes the specified open phone device.
LONG phoneClose(
|
HPHONE hPhone |
|
|
); |
|
Parameters
hPhone
A handle to
the open phone device to be closed. If the function is successful, the handle
is no longer valid.
Return Values
Returns zero
if the request is successful or a negative error number if an error has
occurred. Possible return values are:
PHONEERR_INVALPHONEHANDLE,
PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED, PHONEERR_RESOURCEUNAVAIL,
PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.
Remarks
After the
open phone device has been successfully closed, the implementation sends a
PHONE_CLOSE message to the application. Note that these messages can also be
sent unsolicited as a result of the phone device being reclaimed somehow. An
application should therefore be prepared to handle these unsolicited close
messages. At the time the phone device is closed, any outstanding asynchronous
replies are suppressed.
See Also